<!doctype html>
<html lang="en">
<head>
	<meta charset='utf-8'>
	<meta http-equiv="X-UA-Compatible" content="IE=edge">
	<meta name="viewport" content="width=device-width, initial-scale=1">
	<link rel="stylesheet" href="styles.css">
	<link rel="shortcut icon" href="icon.ico" type="image/x-icon" />
	<link rel="icon" href="icon.ico" type="image/x-icon" />
	<script src="https://code.jquery.com/jquery-latest.min.js" type="text/javascript"></script>
	<script src="script.js"></script>
	<title>Mineways Documentation</title>
</head>
<body>
<div id="wrapper">
	<div id="mineways-header-image">
		<a href="textures.html">
		<img src="images/mineways_header.jpg" alt="Header image" width="787" height="125" />
		</a>
	</div>

	<div id='cssmenu'>
	<ul>
		<li><a href="index.html"><span>Home</span></a></li>
		<li class='has-sub'><a href="downloads.html"><span>Quickstart</span></a>
			<ul>
				<li><a href="downloads.html#downloadImgs">Downloads</a></li>
				<li><a href="downloads.html#instructions">Quick Instructions</a></li>
				<li><a href="downloads.html#referenceHelp">Reference Help</a></li>
				<li><a href="downloads.html#windowsPlatformHelp">Windows Help</a></li>
				<li><a href="downloads.html#macPlatformHelp">Mac Help</a></li>
				<li><a href="downloads.html#linuxPlatformHelp">Linux Help</a></li>
				<li><a href="downloads.html#generalTrouble">General Troubleshooting</a></li>
				<li><a href="downloads.html#knownBugs">Known Bugs</a></li>
				<li><a href="downloads.html#howToPrint">How To 3D Print</a></li>
			</ul>
		</li>
		<li class='active has-sub'><a href="mineways.html"><span>Documentation</span></a>
			<ul>
				<li><a href="mineways.html"><span>Full page</span></a></li>
				<li><a href="textures.html"><span>Textures</span></a></li>
				<li><a href="reference.html"><span>Quick Reference</span></a></li>
				<li><a href="downloads.html#troubleshooting"><span>Troubleshooting</span></a></li>
				<li><a href="mineways.html#rendering"><span>Rendering Tips</span></a></li>
				<li><a href="http://www.youtube.com/playlist?list=PL3AE7AB94E9114715&feature=mh_lolz"><span>Videos</span></a></li>
				<li><a href="scripting.html"><span>Scripting</span></a></li>
				<li><a href="mineways.html#versions"><span>Versions</span></a></li>
				<li class='last'><a href="https://github.com/erich666/Mineways"><span>Source Code</span></a></li>
			</ul>
		</li>
		<li class='has-sub'><a href="community.html"><span>Galleries</span></a>
			<ul>
				<li><a href="community.html"><span>Showcase</span></a></li>
				<li><a href="https://www.youtube.com/playlist?list=PL3AE7AB94E9114715"><span>YouTube</span></a></li>
				<li><a href='http://www.flickr.com/groups/mineways/pool/'><span>Flickr</span></a></li>
				<li><a href='https://www.google.com/search?q=mineways&newwindow=1&source=lnms&tbm=isch'><span>Google Images</span></a></li>
				<li><a href='https://www.shapeways.com/search?q=mineways'><span>Shapeways</span></a></li>
				<li class='last'><a href='https://sketchfab.com/tags/minecraft'><span>Sketchfab</span></a></li>
			</ul>
		</li>
		<li class='has-sub'><a href="http://www.reddit.com/r/mineways/"><span>Community</span></a>
			<ul>
				<li><a href="http://www.reddit.com/r/mineways/"><span>Reddit</span></a></li>
				<li><a href="https://discord.gg/wfayQA6Dyc"><span>Discord</span></a></li>
				<li><a href="https://www.minecraftforum.net/forums/minecraft-java-edition/discussion/326119-mineways-3d-prints-of-minecraft-objects?page=100"><span>Minecraft Forum</span></a></li>
				<li><a href="https://groups.google.com/forum/#!forum/mineways"><span>Google Group</span></a></li>
				<li class='last'><a href="https://github.com/erich666/Mineways/issues"><span>Issues on Github</span></a></li>
			</ul>
		</li>
		<li class='last'><a href="contact.html"><span>Contact</span></a></li>
	</ul>
	</div>
	
	<div id="content" class="clearfix">
<h1>Mineways Main Documentation</h1>

To get started, read this <a href="downloads.html#instructions">quick step by step</a> or watch <a href="https://www.youtube.com/watch?v=xmsnE85GNV8&feature=youtu.be&t=21">this video</a> (and watch <a href="https://youtu.be/wU5YGGGHAGA">this one</a> for some pro tips). For problems, see the <a href="downloads.html#windows">Windows troubleshooting guide</a>; <a href="contact.html">let me know</a> if you're still stuck. Check the <a href="reference.html">quick reference page</a> for a brief rundown of mouse and keyboard controls, menu and export options, and what the files included with Mineways each do. <a href="downloads.html#myway">Read this</a> for the process I go through when exporting for 3D printing.
<P>
Normally you can just hit "OK" on the export dialog and things will work fine. <B>Key tip:</B> hover the mouse over any option in the Export dialog for more information on it.
<P>
Read on if you want to understand how to make your models less expensive, use different texture packs, and otherwise tailor you want to see printed out. What follows is extensive documentation about each part of the export and print process. If you don't want to wade through it all, at least search this page for the phrase <b>"Key tip"</b>, as these bits are particularly useful.
<P>
<div id="googleGroup">
	<p class="noPadNoMarg">Subscribe to the Mineways mailing list - it's for only important announcements, such as new version releases.</p> 
	<form action="http://groups.google.com/group/mineways/boxsubscribe">
	<div>
	  <div>
	  Email: <input type=text name=email>
	  <input type=submit name="sub" value="Subscribe"> <a href="http://groups.google.com/group/mineways">Announcement archive</a>
	  </div>
	</div>
  </form>
</div>
<UL>
<LI><a href="#install">Installation</a> - simple!
<LI><a href="#openworld">Opening Worlds and Schematics</a> - how to view your world.
<LI><a href="#map">Mapping</a> - lots of ways to change the view and what you see.
<LI><a href="#select">Selecting a Region</a> - define a 3D box in your world for export.
<LI><a href="#export">Exporting Models and Maps</a> - basics of exporting.
<UL>
 <LI><a href="#memory">Out of memory?</a> - here are some options.
 <LI><a href="#g3d">Displaying with G3D</a> - free viewer ideal for most Mineways rendering exports.
 <LI><a href="#schemes">Color Schemes</a> - change object colors or make them invisible.
 <LI><a href="#too_big">"My Model's Too Expensive!"</a> - how to keep it cheap.
 <LI><a href="#options">Export Options</a> - rendering-related export options shown on the giant dialog.
 <UL>
   <LI><a href="#terrain_png">Material Export</a>
   <LI><a href="#texture_output">Texture Export</a>
   <LI><a href="#custom_terrain">Custom Terrain</a>
   <LI><a href="#blurry">Blurry Textures</a>
   <LI><a href="#obj_export_options">Wavefront OBJ Export Group Options</a>
   <LI><a href="#full_material">Custom Material</a>
   <LI><a href="#usd_export_options">Pixar USD File Export Options</a>
 </UL>
 <LI><a href="#opt_globals">Global Model Options</a> - modify block coordinates and textures for output
 <UL>
   <LI><a href="#simplify">Simplify mesh</a>
   <LI><a href="#composite">Create composite overlay faces</a>
   <LI><a href="#center_model">Center model around the origin</a>
   <LI><a href="#biome_center">Use biome in center of export area</a>
   <LI><a href="#border_faces">Create block faces at the borders</a>
   <LI><a href="#leaves_solid">Tree leaves solid</a>
   <LI><a href="#rotate_model">Rotate model clockwise</a>
 </UL>
 <LI><a href="#print">Exporting to 3D print</a> - 3D print options.
 <UL>
   <LI><a href="#z_up">Make Z the up direction instead of Y</a>
   <LI><a href="#opt_size">Model Size</a>
   <LI><a href="#opt_fill">Filling and Hollowing Options</a>
   <LI><a href="#lesser">Detailed Blocks</a>
   <LI><a href="#opt_debug">Debugging Visualization</a>
 </UL>
 <LI><a href="#tilemaker">ChannelMixer and TileMaker</a> - how to make your own custom texture terrainExt.png files.
 <LI><a href="#rendering">Rendering Tips</a> - help for importing to different renderers.
<UL>
 <LI><a href="#blender">Blender</a>
 <LI><a href="#ovcreate">Omniverse USD Composer</a>
 <LI><a href="#c4d">Cinema 4D</a>
 <LI><a href="#houdini">Houdini</a> 
 <LI><a href="#3dsmax">3DS MAX</a>
 <LI><a href="#maya">Maya</a> 
</UL>
</UL>
<LI><a href="#sketchfab">Publish to Sketchfab</a> - how to make your creations immediately available to all.
<LI><a href="#print_services">3D Print Services</a> - Shapeways, Sculpteo, and more
<UL>
<LI><a href="#shapeways">Shapeways</a> - two key tricks to use the site effectively.
<LI><a href="#sculpteo">Sculpteo</a> - some options you may not know.
<LI><a href="#zebra">Zebra Imaging</a> - make a color hologram.
<LI><a href="#lookingglass">Looking Glass Factory</a> - make a Lucite block with your model embedded in it.
</UL>
<LI><a href="#scripting">Scripting</a> - how to automate and simplify many Minecraft processes.
<LI><a href="#stuff">Related Resources</a> - model viewers, world editors, and worlds to try out
<UL>
 <LI><a href="#models">Stuff to Print and Render</a> - where to get models and worlds.
 <LI><a href="#packages">Other Packages</a> - other model exporters and related software.
</UL>
<LI><a href="#mcpe">Minecraft Bedrock Support</a> - how to convert Bedrock worlds for use in Mineways.
<LI><a href="#shortcuts">Keyboard Shortcut Keys</a> - along with quick descriptions of various features.
<LI><a href="#blocks">Block Types Supported</a> - how various block types are exported.
<LI><a href="#versions">Version History</a>
<LI><a href="#wishlist">Wish List</a>
<LI><a href="#nightmarelist">Nightmare List</a>
<LI><a href="#offsite">Links</a> - useful links to Mineways-related information.
<LI><a href="#credits">Credits</a> - who did what.
</UL>



<H2 id="install">
Installation
</H2>
Installation is trivial: <a href="https://erich.realtimerendering.com/minecraft/public/mineways/mineways.zip">download</a> and unzip (using <a href="http://www.7-zip.org/download.html">7-Zip</a> or other decompressor) to some directory, like the desktop.
<P>
Uninstall: just delete the directory. If you created color schemes, there will be a few small entries in the registry, If you are fanatical and want to clean these out, delete the ColorSchemes directory at "Computer\HKEY_CURRENT_USER\Software\&lt;your name here&gt;\Mineways", or delete the Mineways directory there altogether.
<P>
Double-click the mineways.exe to run the program.

<H2 id="openworld">
Opening Worlds and Schematics
</H2>
There are many ways to open a Minecraft world or old-style schematic file in Mineways. If one doesn't work for you, try the next.
<P>
<b>File | Open World:</b> In the "File" menu header there is "Open World". Click (or hover) and move to the right to select your world. These are the worlds in your "%appdata%\.minecraft\saves" directory. You can see in <a href="https://youtu.be/lpFpj84eFgw"></a>this video</a> the process of downloading a Minecraft map and putting it in the right place. The worlds are listed by their (not necessarily unique) given names on the left, their folder on the right, and arranged alphabetically by these folders. If you want to specify a different directory for where your world saves are located, use the "-s" option on the <a href="http://www.computerhope.com/issues/chusedos.htm">command line</a> on startup; see the <a href="scripting.html#clo">command line options</a>.
<P>
<a id="blocktestworld">
If you want to export some particular block,</a> use File | Open and select the "[Block Test World]" - this is an internally-generated "world" of blocks, with each block type listed from west to east in block ID order (for 1.12 and earlier; for 1.13 on I've assigned values greater than 255 in a somewhat sensible fashion), and with variants shown from north to south by their <a href="http://minecraft.wiki/w/Data_values#Data">data values</a>. To select a single block, find it, right-click it, then hit "[" to move the bottom level up by one, thus selecting only the block itself and not the surrounding grass.
<P>
Here's a view of a small portion of [Block Test World] exported to OBJ and rendered with Cinema 4D:
<P>
<img src="images/test_world.jpg">
<P>
If you can't find your world in the list, you can select "Find your world..." at the bottom, which is the same as doing...
<P>
<b>File | Open...:</b> This option is for opening old-style schematic files and worlds. Navigate to wherever your schematic or world is stored and select the level.dat file. On Windows, the default folder for world save files is "%appdata%\.minecraft\saves"; for Mac it's "~/Library/Application Support/minecraft/saves/". Worth saying again: you can also load a world by dragging and dropping its level.dat file on to Mineways. Another pro tip: if you save or rename your schematic file to have the world "repeat" in it, e.g., rename "eiffel.schematic" to "eiffelRepeat.schematic", the schematic will load and be repeated across the map, with a minimum one block gap between each model. This can be useful if you want to create a single 3D print file that has multiple copies of the model. Also, for schematics, only, <B>Control-A</B> will select the whole schematic model.
<P>
NOTE: the new schematic file format <a href="https://github.com/erich666/Mineways/issues/40">introduced by FAWE</a> for 1.13 data is currently not supported in Mineways. See <a href="https://github.com/erich666/Mineways/issues/40">this issue report</a> for more information; short version: save you schematic to a world using <a href="https://www.curseforge.com/minecraft/mc-mods/worldedit">WorldEdit</a>, <a href="https://www.curseforge.com/minecraft/mc-mods/litematica">Litematica</a>, <a href="https://intellectualsites.github.io/download/fawe.html">FAWE</a>, or similar, since Mineways can read worlds.
<P>
<b>File | <a id="importsettings">Import Settings:</a></b> If you've previously exported a model from your world or schematic, you can select this data file (.OBJ, .WRL, or for STL export, the .TXT file generated) with Import Settings. Doing so will not only open your world, but will also set all the previous export settings you used to make this export file, including the color scheme and the terrain file chosen. Alternately, you can simply drag and drop one of these files on to Mineways to load it.
<P>
When you import a file's settings, the settings affect only the particular file type. For example, if you read in a WRL file for 3D printing, its settings will not affect OBJ rendering export (or even OBJ 3D printing export, for export settings specific to OBJ files, such as material output). This feature is backward compatible to Mineways 2.0, though features added since then will be given default values. The two exceptions are that the "Create a ZIP" and "create files themselves" export settings are not changed when settings are imported.
<P>
One other useful type of file that Import Settings can read in is a script file. You can create script files to automatically perform all sorts of operations, including special ways of modifying blocks during export. See <a href="scripting.html">the scripting documentation</a> for more information.
</P>
The first image is a schematic <i>pikachu7795240.schematic</i> loaded via "File | Open..." In the second the schematic is renamed <i>pikachu7795240repeat.schematic</i> and loaded. The word "repeat" in the file name tips off Mineways to repeat the object. Also, I typed Control-A to select a single copy of the schematic.
<P>
<img src="images/pika_single.jpg">
<img src="images/pika_repeat.jpg">
<P>
Here is a 3x3 set of objects output and viewed with <a href="#g3d">G3D</a>:
<P>
<img src="images/pika_army.jpg">
<H2 id="map">
Mapping
</H2>
Here's basic map use:
<ul>
<li>Press F3 to take you to your (single player) player's location.</li>
<li>Scroll around by dragging with the left mouse button, WASD keys, or arrow keys.
</li><li>Zoom in on an area by the mouse scroll wheel, Page Up/Page Down keys, or Q/E keys.
</li><li>Mouse over a block and look at the bottom of the screen to see its location and ID. (Note that a coordinate like "-76" means "-75 to -76"; "4" means "4 to 5"). "Y" is the height.
</li><li>Use the slider at the top of the window to slice away all blocks above the given altitude.
</li><li>You can play Minecraft while using Mineways. In Mineways press the "r" key to load your world again, showing whatever changes you made.
</li><li>Search the menu for other options. Some quick notes on these less-descriptive options:
<ul>
<li>The "hide obscured" option removes all blocks above the first air found in caves, making it easier to see the caves themselves. This option is turned on when first viewing the Nether.
</li>
</ul>
</ul>
<H2 id="select">
Selecting a Region
</H2>
To create a 3D file for viewing or printing you first select a 3D box in your world. Whatever is in this box is exported. Hold down the right mouse button (or left mouse and Control key) and drag to define a selection area. If you also hold down the Shift key, the selection region will be square. <B>Key tip:</B> once a region is defined, you can then use the right mouse button to select an edge or corner and drag to fine-tune the rectangle. Hit the space bar to automatically adjust the depth to something reasonable, if need be. <B>Pro users:</B> Using the mouse wheel with the Control key down changes the depth; using it with Shift down changes the visible height (this second mode can be slow, since the map is regenerated). 
<P>
Once you make a selection, you may get a dialog as shown below. Mineways will detect when what you see is not what you'll get. It will ask if you want to set the depth so that everything you can see from above that you have selected will be exported.
<P>

<div id="terrainSelection">
  <b>Example Region Selection:</b>
  <div id="terrainImgs">
    <div class="terrainImg">
      <img src="images/select1.jpg">
      <span class="caption">At first, the selected area excludes some terrain visible from above, as the current depth is too high.</span>
    </div>
    <div class="terrainImg">
      <img src="images/select2.jpg">
      <p class="caption">Choosing "yes" lowers this depth and adjusts the slider</p>
    </div>
    <div class="terrainImg">
      <img src="images/select3.jpg">
      <p class="caption">Note that sometimes the adjusted depth becomes too low, for example when the selection includes a deep hole. In photo above, the depth has been increased to the point where some terrain is now unselected. Bright pink shows terrain exactly at this depth.</p>
    </div>
  </div>
</div>
<P>
By default, the heights used for the rectangular block are from y=63 (sea level) to y=255. The upper slider determines the visibility height, but usually you'll leave this one alone. You'll normally use it for viewing or selecting areas fully underground or in the Nether (or poking around your map to look for diamonds and other hidden treasures).
<P>
The selected export depth can be changed in a number of ways, even when no area is selected. The Depth slider is the simplest way to modify this value. If you click the middle mouse button on a location, the depth is set to its height. The <b>[</b> and <b>]</b> keys shift the depth by one, and so are useful for tuning. The spacebar will also select a reasonable depth for your selection volume, based on visibility (water is considered invisible, so that the bottom of lakes will be solid). Holding shift while tapping the spacebar will treat water and glass as opaque, useful for 3D printing. To micro-adjust the Height, use the <b>&lt;</b> and <b>&gt;</b> keys (with or without holding Shift). See <a href="reference.html#shortcuts">the full shortcut key list</a> for more options.
<P>
<a id="viewers">
<B>Key tip:</B></a> to see what you're doing, export the model and view with <a href="#previewing">a viewer</a>. I usually work by adjusting the box size and export options in Mineways, export, then viewing the file in <a href="#g3d">G3D</a> (which reloads the viewed file when you tap the "r" key) or, for .WRL files, <a href="http://meshlab.sourceforge.net/">MeshLab</a> (unfortunately, their Alt-R reload doesn't clear out the previously-loaded file) to see the results.

<H2 id="export">
Exporting Models and Maps
</H2>
If you want to render the model, select "Export for Rendering" from the File menu, or use Control-R, and save your file. The resulting file(s) can then be imported into a huge variety of 3D modelers and viewers, e.g., <a href="http://blender.org">Blender</a>. See <a href="#rendering">this section</a> for instructions for various popular modelers.
<P>
You can select "Export Model for 3D Printing", Control-P, to create a model suitable for sending to a 3D printer. Even if you don't have a 3D printer, you can still get it printed, usually for a reasonable price. See the <a href="#too_big">next section</a> for how to get going.
<P>
The big difference between rendering and printing is that 3D print models <i>must</i> be solid and well-formed. Currently Mineways treats all blocks as solid, full blocks: half-steps or stairs are treated as blocks, as is every other block. There is also no transparency for the materials, since printers do not currently support this type of creation. Models for rendering can, when full texturing is on, include billboard models for flowers, saplings, crops, and other elements. Note that the billboard locations are added in comments to the output .OBJ and .WRL files. In this way, a dedicated modeler could substitute his own elaborate grass, flower, or other models in place of the simple billboards Minecraft provides.
<P>
To make your model immediately viewable on the web in 3D, choose the third option "Publish to Sketchfab." Mineways directly uploads your model to the Sketchfab site and makes it displayable to everyone. It's fun and easy, honestly. <a href="#sketchfab">Go here</a> for detailed instructions.
<P>
<a id="schematic">
The next option is "Export Schematic",</a> which allows you to then import your model to another world by using <a href="https://www.amuletmc.com/">Amulet</a>, <a href="https://minecraft.curseforge.com/projects/worldedit">WorldEdit</a>, <a href="https://www.curseforge.com/minecraft/mc-mods/litematica">Litematica</a>, or <a href="https://intellectualsites.github.io/download/fawe.html">FAWE</a>. Note that Mineways can read any old-style schematic file by using <a href="#openworld">"File | Open..."</a>.
<P>
Schematic files are commonly used to share constructions among builders. You can upload and share these files on sites such as <a href="http://planetminecraft.com">Planet Minecraft</a>. Signs will not have text, chests will lose their contents, objects such as <a href="http://minecraft.wiki/w/Paintings">paintings</a> are not exported, and <a href="http://minecraft.wiki/w/Head">heads</a> are turned into pumpkins. Currently no export options beyond the dimensions and the rotation angle affect schematic export in Mineways, and the rotation angle only partially works, mostly for full blocks that do not have any orientation. In other words, the orientation angle will rotate the model as a whole, but each individual block will not be rotated: stair steps and signs will still go the old direction, rails get "interesting," and so on. I'd avoid it... Also, 1.13 and newer elements will export as grass blocks and a warning is issued, since the standard schematic format does not support these. Mineways <a href="https://github.com/erich666/Mineways/issues/40">does not support the new schematic format</a>, sorry.
<P>
<a id="exportmap">
"Export Map" is simple: whatever area you have selected is exported to a PNG-format image file, named as you wish. The zoom level affects the result, though will differ slightly from what you see on the screen for boring reasons. While you can manually export any portion of the map manually, the real power is from using <a href="scripting.html#sic">scripting</a>. You can make a simple text file to specify more than one map. Each map can be set to display a different part of your world, or even a different layer, by adjusting the maximum Y height. See (and run) the sample file "scripting/make_map_tiles.mwscript" for an example that creates four adjacent 1000x1000 maps centered around location 0,0. 
<P>
If you want to edit these maps, consider using <a href="https://imagemagick.org">ImageMagick</a>, which lets you perform <a href="https://imagemagick.org/script/command-line-processing.php">all sorts of annotations</a> and much more. See the file mineways_annotate_map.bat, which shows how to create a PNG map file, then run annotate_map.py to create a .bat file that then calls ImageMagick to annotate the map with coordinates and map file areas.
<P>
See the file "scripting/make_slice_maps.mwscript" for making a series of layers that you can turn into an animation. You can then make <a href="https://erich.realtimerendering.com/minecraft/public/crazycake_slices.gif">animations like this</a> (and <a href="https://erich.realtimerendering.com/minecraft/public/crazycake_slices_slow.gif">at a slower speed</a>): 
<P>
<img src="https://erich.realtimerendering.com/minecraft/public/crazycake_slices.gif" alt="slice animation">
<img src="https://erich.realtimerendering.com/minecraft/public/crazycake_slices_slow.gif" alt="slice animation slowed">
<P>
<H3 id="memory">Out of memory?</H3> Under "Help", the "give more export memory" frees memory as possible while exporting. This option can allow you to export a large model you normally couldn't, at the cost of slower map update and export. What it does is unloads all stored world chunks (the 16x16x256 high pieces of your world) when exporting, reloading these after export. Also, the chunks loaded get reduced in size, which can help showing large maps on extremely limited machines (such as Windows 32). If that fails, you can <a href="scripting.html#uie">use scripting to export your world</a> as separate "hunks."

<P>
<h3 id="g3d">Displaying with G3D</h3>
Once you have a model for rendering, you might want to preview it before importing it to 3D modeler. If you are using Wavefront OBJ files (the default), I recommend the free G3D viewer (pro tip: hold the Alt key down and use WASD to move fast in G3D). This viewer now recognizes a special tag in the OBJ's material description that makes Mineways models display with the classic blocky Minecraft look. If you use VRML or STL files, <a href="http://meshlab.sourceforge.net/">MeshLab</a> is a fine free viewer for these other formats for 3D printing (however, it does not handle transparency and cutouts well, so is poor for viewing renderings).
<P>
<B><a href="https://erich.realtimerendering.com/minecraft/public/mineways/g3d.zip">Download this special version of G3D here</a>.</B> Unzip and run, then drop your .OBJ file on to the window to view it. Simpler yet, you can set up your Windows system to view .OBJ files with G3D when double-clicked. Just run register-G3D-viewer64-run-as-administrator.bat one time as administrator (see <a href="scripting.html#amfwm">these instructions</a> to learn how).
<P>
Camera controls: WASD for normal movement, ZC for up and down, QE for swivel. Hold down Shift to go more slowly, Alt to go fast. Escape to quit.
<P>
Aside from being a lovely renderer, G3D has additional features such as making a screenshot (F4) and recording a video (F6). Press F11 to see various developer features. The <a href="https://casual-effects.com/g3d/www/index.html">master G3D site is here</a>.
<P>
Here's an example, side to side, of a lot of the blocks in Minecraft.
  <P>
  <p><a href="#g3d">G3D</a> displaying an OBJ rendering file:</p>
  <div>
    <img src="images/g3d_view.jpg" alt="OBJ render with G3D">
  </div><P>
<h3 id="schemes">Color Schemes</h3> 
Color schemes allows you to change the color for many blocks, and - useful for 3D printing and some rendering applications - remove any blocks you want from view. <b>One tip:</b> you can eliminate all glass from your model by setting its alpha to 0 in a color scheme. <a href="http://www.youtube.com/watch?v=9ZJZMZEfEC0&t=7m20s">This part of this video</a> shows how to use color schemes to do this.
<P>
<B>Note:</B> with the new file format introduced with Minecraft 1.13, the whole "blocks from 0-255" way of listing block types is not valid for newer blocks. Mineways still uses a form of this internally, so the feature is still in place. Also, Mineways has evolved to provide colors for different colored blocks of the same type. For example, the various wool blocks will display using their colors. Changing the color of the wool block using a color scheme will change only the white wool version of the block. Color schemes still have their uses, such as for removing some blocks from view and from export. Color schemes use my internal block type numbering system for blocks from 1.13 on. If you get flaky problems with older color schemes, at worst you can always run REGEDIT and delete the ColorSchemes directory at "Computer\HKEY_CURRENT_USER\Software\&lt;your name here&gt;\Mineways".
<P>
How to use a color scheme: From the menu, Add a new color scheme, then Edit it. Change the name "Color Scheme" at the top of the dialog that pops up to something useful, then select any block type to edit it. Color is given in <a href="http://en.wikipedia.org/wiki/Hexadecimal_color">hexadecimal color format</a>. You can use <a href="http://www.mirekw.com/winfreeware/mwsnap.html">MWSnap</a> (old but free), <a href="http://www.faststone.org/FSCapturerDownload.htm">FastStone Capture</a> (new but costs $20), or other programs to find the hexadecimal (e.g., #787878) color value of any pixel on your screen. 'Alpha' says how opaque a block will appear on the screen, with 255 meaning fully opaque and 0 meaning fully transparent (invisible). <I>Blocks with an alpha of 0 will be deleted when exporting.</I> You can turn off export of <i>all</i> blocks by using the "Hide All Blocks" button. This feature allows you to create separate parts, e.g., a glass roof could be created by then turning on just glass export. The "Hide Tree Blocks" hides all log and leaf blocks, making printing of 3D terrain simpler (trees are sometimes hard to print well).
<P>
Changing the color will affect the 3D print model's color for only the "solid material colors" and "richer color textures" export modes; "full color texture patterns" (the default on the export dialog) will not be affected (except water, a little bit). To change full color textures' colors, you need to edit the input terrainExt.png itself. See <a href="textures.html#own_terrain">Creating Your Own Terrain Files</a>.

<H3 id="too_big">
"My Model's Too Expensive!"
</H3>
If you export to 3D print and upload to Shapeways, you might be surprised to find that the price is sometimes just shy of a used car. For example, <a href="http://www.shapeways.com/model/422470/spawn.html?gid=ug">this model of our spawn area</a> is 15 x 9.8 inches in size (about 190 x 125 blocks, 2 mm wide), and costs $633.14. Expensive models happen because either the model is too small, or too large. The problem with models with only a few blocks in them is that you'll then scale it up to see it: each block itself is then massive. You have to pay for each block's volume. Mineways can't help you much there, you'll need to use a CAD program to hollow out your object manually. Shapeways has <a href="http://www.shapeways.com/tutorials/creating-hollow-objects">a tutorial on hollowing</a>.
<P>
The more common problem you can hit is the blocks are not small enough.
This happens with larger models, those 100+ hour darlings you sweated over in Minecraft. The cause is that, by default, Mineways exports the model to print at a safe size. Colored sandstone has a <a href="http://www.shapeways.com/tutorials/3dprintingminimumwallthicknesstutorial">thin wall dimension</a> of 2 millimeters. This means if some wall in your model is less than 2 mm thick, it is in danger of breaking into pieces if printed in color.
<P>
Rule of thumb: colored sandstone has a cost of $6 for every thousand blocks printed at the default 2 mm/block. There's a fixed cost of $3 per model, and $6.50 shipping. For example, if you want to spend $50, at this scale your model can have about 6750 blocks, after subtracting the fixed costs.
<P>
There are some solutions to the price problem:
<UL>
<LI>Switch to the white and flexible physical material. Choose this material in the options dialog on export and the thin wall minimum drops to 0.7 mm. This brings the price (and size) of your model down, from about $6.00 per thousand blocks to $0.48 per thousand. You do lose color printout, but can <a href="https://support.shapeways.com/hc/en-us/articles/360033930173-Cleaning-and-painting-Fine-Detail-Plastic-models">paint the model yourself</a>. Your model should print safely.
<LI>Print it smaller and cross your fingers. Change "Make each block 2 mm high" to "Make each block 1 mm high", for example: at 1 mm/block, you can print 8 times as many blocks as 2 mm/block: $0.75 per thousand blocks. I like this scale a lot, it's cute. Two examples: <a href="http://www.shapeways.com/model/458361/small-bowl.html">World in a Bowl</a> and <a href="http://www.shapeways.com/model/432763/sentinel-1mm.html">Sentinel Castle</a>. If you don't have any tree trunks (which at 1 mm <a href="http://www.flickr.com/photos/postapocalyptic/6606215281/in/pool-1862849@N21/">will snap right off</a>), thin walls, or other filigree, the model should be fine. You can remove trees from your model by using a <a href="#schemes">color scheme</a> that makes leaves and logs invisible. See <a href="http://www.youtube.com/watch?v=9ZJZMZEfEC0&t=7m20s">this video</a>, which shows how to make glass blocks invisible; just do the same with logs and leaves. At worst, at 1 mm other little bits might break off. Companion cubes will print with no problems, models of ships with thin masts and lanyards are much less likely to survive. Keep going smaller until you like the price, or simpler yet, just choose the scaling option "Aim for a cost of $25.00" or whatever you want. Note that Shapeways itself might refuse to print your model if they believe some parts are too thin to support the structure; <a href="images/model_fail.jpg">here's an example</a> where Shapeways decided the support struts were not thick enough.
<LI>Learn more about the options below. Proper use of "fill bubbles" and "super-hollow" can easily combine to reduce your costs by 2/3rds. <a href="#seal">"Seal off entrances"</a> and "Fill in isolated tunnels" can also help. These options are useful for going to a smaller scale but still having thick enough walls. The strategy I like is to have the interior of the building get filled with blocks by using "fill bubbles" and then have "super-hollow" remove most of these blocks, leaving a shell that's thick enough to print. Long and short, don't print what you can't see.
</UL>
By the way, I hear "it would be cheaper using LEGOs" a fair bit. LEGO blocks cost around 4-5 cents a block, 2 mm colored sandstone 3D printed blocks run about 6/10th of a cent. There are advantages to LEGOs (larger, reusable, fun to make) and disadvantages (no textures, not perfect cubes), but LEGO cost is not an advantage.
<P>
<P>
By default, <a href="http://en.wikipedia.org/wiki/Wavefront_OBJ">Wavefront OBJ</a> *.obj (and *.mtl) files are exported for rendering, <a href="http://en.wikipedia.org/wiki/VRML">VRML97</a> (aka VRML2) for 3D printing. Here's the rundown of the various file types you can select, including some subtleties about each. If you want to export to the <a href="https://www.khronos.org/gltf/">glTF</a> format, one indirect way is to <a href="#sketchfab">upload to Sketchfab</a>, make the model downloadable, then download from there.
<P>
<B>OBJ, absolute:</B> Wavefront OBJ is an old format, so is commonly supported as an import format for a huge range of applications. If you export materials, a corresponding *.mtl file is output; if you export textures, one or more *.png files are also created. The .obj and .mtl files are text files, so can be edited or processed further. By selecting <a href="http://www.fileformat.info/format/material/">"absolute"</a> for the OBJ file, indices are absolute (positive), the norm. This is the format to use for export for upload to <a href="http://sculpteo.com">Sculpteo</a>. See other export choices in the <a href="#obj_export_options">OBJ file export options</a> documentation.
<P>
<B>OBJ, relative:</B> <a href="http://en.wikipedia.org/wiki/Wavefront_OBJ#Relative_and_absolute_indices">relative indices</a> are used on faces. These allow you to concatenate two or more OBJ files into a single OBJ file.
<P>
<B>Binary STL:</B> This file format is commonly used by 3D printers. It normally is used for single-color materials, but the exporter will use either the Materialise Magics or VisCAM format to attach colors to triangles - see <a href="http://en.wikipedia.org/wiki/STL_(file_format)#Colour_in_binary_STL">this article</a>. I recommend using VisCAM's variant, as MeshLab will then display the proper model colors. When STL files, binary or ASCII, are exported a corresponding *.txt file is generated with information about the model. This same data is included in the beginning of the *.obj and *.wrl files themselves. This text file can be read back into Mineways using "Import Settings" to set everything back the way it was set before.
<P>
<B>ASCII text STL:</B> A variant for 3D printers, the file generated is considerably larger than the binary form and cannot include color. The main advantage is that this file type is a simple text file and so can be easily edited. The format is trivial and so can provide a raw set of triangles for a model.
<P>
<B>VRML97:</B> Also known as VRML2 or VRML 2.0. While this format has been superseded by <a href="http://en.wikipedia.org/wiki/X3d">X3D</a>, it is commonly supported by a wide range of packages. That said, its main reason for existence here is that it's the only file format that Shapeways uses for colored models. The *.wrl and *.png file created are put into a zip file and uploaded to Shapeways for printing - see more about this process <a href="#shapeways">below</a>. The VRML file produced is tailored toward making a single texture for printing. Note: Shapeways will properly preview all VRML output modes other than "solid material colors", where it has a limit of 16 different colors. These colored models will print fine, however.
<B>VRML97:</B> Also known as VRML2 or VRML 2.0. While this format has been superseded by <a href="http://en.wikipedia.org/wiki/X3d">X3D</a>, it is commonly supported by a wide range of packages. That said, its main reason for existence here is that it's the only file format that Shapeways uses for colored models. The *.wrl and *.png file created are put into a zip file and uploaded to Shapeways for printing - see more about this process <a href="#shapeways">below</a>. The VRML file produced is tailored toward making a single texture for printing. Note: Shapeways will properly preview all VRML output modes other than "solid material colors", where it has a limit of 16 different colors. These colored models will print fine, however.

<HR>
<H3 id="options">
Export Options
</H3>
<p>
There is a bewildering dialog that pops up on export, with a ton of options. You can blithely ignore this dialog and just click <B>OK</B> (or hit the Enter key). But, there are lots of variations possible: you may want to animate individual blocks, need special options for your rendering program, want to resize or reposition your model, on and on.
<P>
When this dialog is up in the program, you can hover over most of the options to get a bit more information on what each is about; some you have to hover over the box itself.
<P>
If you find you always want certain options set, you can easily do so using mineways.bat to start the program and edit the script file scripting/startup.mwscript. See those files and <a href="scripting.html#clo">scripting</a> for more on doing so.
<p>
<B>Click on the image below</B> to be taken to the relevant documentation (yes, old-school image map!):
<p class="center">
<img src="images/export_dialog.jpg" usemap="#image-map" alt="export dialog">
<!-- Image Map Generated by http://www.image-map.net/ -->
<map name="image-map">
    <area target="" alt="coordinates" title="World coordinates selection" href="#opt_coord" coords="0,0,433,121" shape="rect">
    <area target="" alt="zip and files" title="zip and files" href="#opt_zip" coords="0,122,433,143" shape="rect">
    <area target="" alt="materials" title="Material Export" href="#terrain_png" coords="0,144,281,249" shape="rect">
    <area target="" alt="textures" title="Texture Output" href="#texture_output" coords="0,250,281,269" shape="rect">
    <area target="" alt="grouping" title="Export Group Options" href="#obj_export_options" coords="282,144,433,257" shape="rect">
    <area target="" alt="custom material" title="Custom material" href="#full_material" coords="282,258,433,307" shape="rect">
    <area target="" alt="lighting" title="USD Lighting" href="#opt_lighting" coords="0,270,281,307" shape="rect">
    <area target="" alt="global options" title="Global Model Options" href="#opt_globals" coords="0,308,433,415" shape="rect">
    <area target="" alt="up and size" title="up and size" href="#print" coords="434,0,905,151" shape="rect">
    <area target="" alt="3D print and fill" title="3D print and fill" href="#opt_fill" coords="434,152,906,315" shape="rect">
    <area target="" alt="debug" title="debug" href="#opt_debug" coords="434,316,711,415" shape="rect">
<!--     <area target="" alt="help and exit" title="help and exit" href="#opt_ok" coords="712,316,906,415" shape="rect"> -->
</map>

<p>
<B><a name="opt_coord">World coordinates selection</a>:</B> you can see and change the 3D volume of space to export from your world. If you want to know the location of a place in your world, use the F3 key when playing Minecraft. Note that negative values like -5.239 will round down to -6. Also note that your Y-value altitude is one higher than where your feet are located, and so two higher than the ground beneath you.
<P>
<B>Key tip:</B> If you exported a model in an earlier session and want to use the same settings for another export, read the model file (.OBJ, .WRL, or for STL the .TXT file) with the <a href="#importsettings">"Import Settings" command</a> from the "File" Menu. Simpler still, just drag and drop the model file on to Mineways!
<P>
<b><a name="opt_zip">Create a ZIP:</a></b> like it says, when exporting for 3D printing a ZIP file of the exported files is created, ready for upload for 3D printing at Shapeways or other service.
<P>
<b>Create files themselves:</b> the exported files themselves are also made available for previewing. By default, this option is off for VRML 3D printing, on for everything else. This is done because too often the .wrl file got uploaded to Shapeways; you must upload the .zip file.


<a id="terrain_png"><H4>Material Export</H4></a>

Remember that for any format you can turn off a block from being output (and being visible) by setting its alpha to zero in your own <a href="#schemes">color scheme</a>.
<P>
On the left of the dialog are texture options:
<UL>
<LI>"Export no materials" option is just that. For example, for OBJ, no .mtl file is generated.
<LI>"Export solid material colors" will give solid swatches of color for each material. The <a href="#schemes">color scheme's</a> colors controls these.
<LI>"Export noise textures with color" gives textures that have some noise in them. For the OBJ file format the difference is that a PNG texture file is output; VRML97 always exports a texture for any material option. The <a href="#schemes">color scheme's</a> colors controls these. Rarely used or useful, but gives a different look.
<LI>"Export all textures to three large, mosaic images" creates three large images - RGB/A/RGBA - of all possible textures needed, in a grid. See additional note following this list. This option requires the terrainExt.png file, reading this file to create full textures for each block, as possible. The <a href="#schemes">color scheme</a> affects only the water color: the higher the alpha set, the more of the base color you define is combined with the water texture. So, for a deeper blue, you can define the two water colors (note there's a "stationary water") as dark blue or even black and a high alpha, e.g., 200.
<LI><a id="fcst">"Export individual textures to"</a> can be used only when exporting OBJ and USDA files for rendering. It is like "Export all textures to three large, mosaic images," above, but instead single images are exported for the block faces, by default to a subdirectory "tex". For USD the textures are places in the "yourfilename_materials" directory instead of "yourfilename_materials/tex". If the "tex" directory is set to blank instead of "tex", all output files are placed in the same directory as the main output file - no subdirectories are used. This can be a good thing for multiple exports, as only a single copy of the textures needed are output. The "tex" option is meant to help avoid any confusion about which textures go to which exported models.
</UL>
The "Export individual textures" option creates many more (smaller) textures, but can be considerably faster since not all textures are exported. These textures are similar to Minecraft's block textures, though possibly modified to improve how alpha cutouts look. This mode allows you to later modify and swap individual textures in other applications such as Blender. It also is a better option for exporting high resolution texture resource packs (where the block faces are 256x256 or larger), as having a single, large texture (as generated by the other options above) can be too large for systems such as Blender. Since each texture is separate, <a href="https://en.wikipedia.org/wiki/Mipmap">mipmapping</a> works correctly for distant blocks. Various options are ignored in this mode, such as the various OBJ grouping and material options and the composite overlay faces checkbox. Note that if you want to manually upload an OBJ with separate image textures, Sketchfab has a 100 texture image upload limit (and you may need to uncomment "map_d" in the materials file). Finally, if you make a zip and do not check "create files themselves," the PNG texture files will not be deleted, since they may be shared by other exports.
<p>
Content is shown on the left exported with "all textures to three large images" and on the right with "individual textures." <a href="https://en.wikipedia.org/wiki/Mipmap">Mipmapping</a> works properly with individual textures.</p>
<div>
  <img src="images/mip_bleed_be_gone.jpg" alt="mip bleeding vs. not bleeding">
</div>


<a id="texture_output"><H4>Texture Output</H4></a>

These options were originally for the "three larger, mosaic images" export option, but can also be used with the default "Export individual textures" option. For this second option, unchecking all three checkboxes means no texture images themselves get exported. The output model file(s) will still reference the textures. Used properly, turning off texture output can save you time each time you export a model. For example, say you export a model, then realize you want to export it again, but with a smaller volume. In that case, the model will use the same or fewer textures, so you could turn off texture output. Another use is when you want a model to use a directory of customized textures and do not want to overwrite it.
<P>
If you "Export all textures to three large images", by default there are three types of files that can be output to PNG files, as needed. "RGB" is a colors-only file, "RGBA" is colors and transparency, "A" is just the transparency values. For 3D printing, only the RGB file is exported. For rendering export, if any blocks needing transparency are found in your model, then the "RGBA" and "A" files are also exported. Some rendering systems need only one or two of these file types, not all three. If you know this in advance, turn off the export textures you don't need.
<P>
The "texture output" export option can save you much time if you are exporting the same model a few times (e.g., you're editing its bounds), especially while using a large custom terrainExt file (see the next paragraph for what that is). You can export your model once with textures on, then modify your export and, by exporting to the same file name, you don't need to export the textures again.
<P>

<a id="custom_terrain"><H4>Custom Terrain</H4></a>
The one file you may want to change is the terrainExt.png file that comes with Mineways. To select a different terrainExt.png file, use the "Choose Terrain File" under the File menu. You can also simply drag and drop a terrainExt*.PNG file on to Mineways. In either case, at the very top of the Mineways program you'll see what terrain file is active, right after the name of the world you've opened. Mineways supports a number of premade terrainExt.png files for you to try.
Visit the <a href="textures.html">Textures page</a> for previews and download links for terrain files not included in the Mineways distribution.

<P>
<a id="default_terrain">If you have a terrain PNG file you would always like to use by default, copy it into the directory where mineways.exe is located and call it terrainExt.png, replacing the one that is there. For example, if you always want to use terrainExt_Smoolistic.png, delete (or, better, rename) terrainExt.png, then copy terrainExt_Smoolistic.png to terrainExt.png. If you know how to use <a href="https://www.computerhope.com/issues/chusedos.htm">the command line</a>, a better way is to use a <a href="scripting.html#clo">command line option</a> to specify the terrain file to use on startup, e.g., "mineways.exe -t terrainExt_Smoolistic.png". Better still, you could make a <a href="https://www.windowscentral.com/how-create-and-run-batch-file-windows-10">batch file</a> called, say, "my_mineways.bat" that contains the single line "mineways.exe -t terrainExt_Smoolistic.png" and double-click that to start up using your preferred terrain file.
<P>
Mineways in fact comes with "mineways.bat", which resizes the startup window and calls the scripting/startup.mwscript script (which does nothing, but can be edited to perform various startup commands). Yet another way is to use File->Import Settings and read in <a href="scripting.html#modelExportTable">a Mineways script</a> to change the terrain file. This is handy for exporting the same model multiple times, each time with a different terrain file applied.

<P>
For a more thorough explanation of textures and how they're used in Mineways, read the <a href="textures.html">Textures page</a>.
To make terrainExt.png files yourself, see <a href="textures.html#own_terrain">Creating Your Own Terrain Files</a>. 

<P>
<B>3D Printing:</B> The effective 3D print resolution of textures appears to be around maybe 10x10 for the default output block size of 2 mm/block. Fine details are unlikely to be visible, though sometimes I'm surprised to see them.
</P>

<div id="textureImgsSet">
  Click on an image for higher resolution versions.
  <div id="textureImgs">
    <div class="textureImg">
      <a href="http://www.flickr.com/photos/68387974@N02/6803344170/in/pool-1862849@N21/">
        <img src="images/small_grill.jpg" alt="small grillwork"></a>
      <span class="caption">This model was made using <a href="http://www.minecraftforum.net/topic/45534-glimmars-steampunk-v37132x12-animated-cogs-alchemy-at-work-in-a-dark-victorian-industrial-world-updated-28thfeb-fixes-64x-waterlavaetc/">Glimmar's Steampunk terrainExt.png</a> and printed at 2 mm/block. It appears that the glass cube grillwork texture has some synchronization problem with the printer, causing the pattern to sometimes print out incorrectly.</span>
    </div>
    <div class="textureImg">
      <a href="http://www.flickr.com/photos/68387974@N02/6841200607/in/pool-1862849@N21/">
        <img src="images/small_chain.jpg" alt="3 mm chain"></a>
      <p class="caption">This model is printed at 3 mm/block and shows the original 16x16 TNT texture; however, at both ends the fidelity becomes poor.</p>
    </div>
    <div class="textureImg">
      <a href="http://www.flickr.com/photos/postapocalyptic/6766498167/in/pool-1862849@N21/">
        <img src="images/small_chest.jpg" alt="5 mm chest"></a>
      <p class="caption">This model, from <a href="http://www.flickr.com/photos/postapocalyptic/6766498167/in/pool-1862849@N21/">Alexander Boden</a>, is a 5 mm/block print which clearly shows details such as cobblestone and tree bark.</p>
    </div>
  </div>
</div>

<H4 id="blurry">
Blurry Textures
</H4>

If your rendering software doesn't show the distinctive blocky style of Minecraft, you can fix this in two ways. The first is to set texture sampling in your renderer to be "closest" or "nearest neighbor." This is the easiest solution, though can make mipmapping unavailable. See the instructions for the <a href="#rendering">various renderers</a> for more information. The other option is to use higher-resolution textures, which will simulate turning bilinear interpolation off.
<p>
On the left, the basic 256 x 544 terrainExt.png file is used; on the right, the input terrainExt.png image is resized (without filtering) to 1024 texels wide. You can download high-resolution versions of terrainExt.png: <a href="https://erich.realtimerendering.com/minecraft/public/mineways/downloads/terrainExt1024.png">1024 wide</a> and <a href="https://erich.realtimerendering.com/minecraft/public/mineways/downloads/terrainExt8192.png">8192 wide</a>. In Mineways do "File | Choose Terrain File" and select either; the higher-resolution version gives sharper results, at the cost of memory.</p>
<div id="terrainExtImgs">
  <img src="images/spawn_lores.jpg" alt="low resolution">
  <img src="images/spawn_hires.jpg" alt="high resolution">
</div>
<P>
You can also interactively compare these sampling methods <a href="https://skfb.ly/Ksu7">here</a> vs. <a href="https://skfb.ly/KsUZ">here</a>.
<P>
These textures are for the default Minecraft appearance. To avoid blur for your own terrainExt.png file, resize it to be say 4x larger in both directions. You can use the <a href="textures.html#tilemaker">TileMaker program</a> included with Mineways (use the "-t tileSize" option), or any other image manipulation program (I'd use "nearest neighbor", if possible - <a href="http://www.irfanview.com/">IrfanView</a> has this option when resizing a texture by doing "Size method: Resize"). Note: from experimentation, this higher resolution <i>does not</i> improve the clarity of 3D texture printing.
<P>
There is a case where you'll want your textures to be blurry: when they're far in the distance. Usually, mipmapping is done by a renderer to make this happen.
The Minecraft block textures are normally put in one large texture and each is given a border 1 pixel wide. This border avoids bilinear interpolation artifacts. However, mipmapping for extremely far blocks will not work well, since block textures are next to each other in this big texture. The solution is to either "Export individual textures" (where each block face is exported to its own texture), or disable mipmapping for rendering and live with the artifacts (other sampling techniques should work fine).
</P>


<a id="obj_export_options">
<H4>Wavefront OBJ Export Group Options</H4></a>

If you find you want your model data to be arranged a bit differently for your rendering system, there are a bunch of options. These vary how Minecraft blocks are grouped and how materials are shared among different block types. Every rendering system imports OBJ files differently, so try different combinations and see what you prefer. Most of these options do not affect display. These options are mostly for determining how much control you have over modifying materials and moving blocks around.
<P>
<a href="https://en.wikipedia.org/wiki/Wavefront_.obj_file">Wavefront OBJ</a> has two concepts when it comes to polygon faces: named objects and named groups. In Mineways there can be one or more objects in a scene, each object can have zero, one, or more groups inside of it. Normally there is just one object exported; the "Make groups objects" creates a separate object which then contains a corresponding group.
<P>Mineways has (rough) "block families." For example, the <a href="https://minecraft-ids.grahamedgecombe.com/">Stone family</a> has stone, granite, polished granite, diorite, and so on. Each block in this family has a separate "type." Materials can be output by one per family or one per type.
<P>Any number of polygons can be in an object or group. There is also a set of materials (defined in the .mtl file). One and only one material is applied to each polygon.
<UL>
<LI>Export separate types: on by default, this option says each type of block - stone, logs, fences, and so on - are put in a separate group. Turning this option off means no groups are created, which can be useful for simplifying import into rendering packages but can make editing more difficult. This option does not affect how many materials are generated.
<LI id="individual" class="ib">Export individual blocks: This option is mutually exclusive with the previous option, "Export separate types." Normally Mineways exports only those faces that are visible. By checking this box, <i>all</i> faces of <i>every</i> block are output, allowing you to animate such operations as mining or explosions. This considerably increases file size and render time, so use it only if you need it. You may also want to check the <a href="#make_groups_objects">Make groups objects</a> option, e.g., for Blender export, as each group will then be a separate object you can manipulate. For Blender you'll also want to make sure "Material per family" is checked. Note that the individual blocks option will change the appearance of some blocks, such as water and glass blocks, as all faces now have sides, which are visible. Normally Minecraft removes these interior sides (e.g., where two glass blocks share a face), but this option makes them visible. This option works for OBJ and <a href="#usd_export_options">USD export</a>.
<LI>Material per family: on by default. <i>Only affects export when exporting the three large mosaic textures</i>. When on, the default, blocks in a family (or type; see next option) have their own material. If turned off, a single material is used for all objects. When exporting individual blocks, this checkbox affects whether each block is in its own group (making it easier to edit: move, delete, etc.) or whether individual blocks are grouped by material. To reiterate, this option does not affect anything when exporting individual textures, as each individual texture needs its own material and so materials cannot be grouped.
<LI><a id="material_subtypes">Split by block type</a>: Blocks have a family and a type. When checked (the default), the individual types are used for grouping polygons and, for mosaics, generating materials. You can see many of the families <a href="https://minecraft-ids.grahamedgecombe.com/">on this page</a>, e.g., Stone, Granite, Polished Granite..., through Polished Andesite are a family. New groups are generated when there's a physical difference in the material itself, not just geometric changes. For example, campfires, sea pickles, and respawn anchors will be given <a href="https://minecraft.wiki/w/Light">separate emission levels</a> when this box is checked; else the maximum light level is assumed. Usually you'll want this box checked, unless you're finding you would rather have fewer groups (and fewer materials, for mosaics).
</UL>
<P>
Confused yet? There are non-obvious interactions among the various settings. A table follows, describing the results when using this 2x3 set of blocks - two grass blocks, two stone, two diorite - as the exported volume, and when using the large mosaic texture option. Recall that diorite is part of the stone family. This table fully applies when using the "three mosaic image" material output option. For individual texture output, the "Material per family" option is grayed out, since it has no effect. Results are described as "For mosaics" when materials are output using "three large, mosaic images" mode and "For individuals" when using "individual textures" mode. Note that for individual texture output, it is always the case that different textures will need different materials.
<P>
<img src="images/grass_stone_diorite.jpg">

<TABLE id="objectMaterialCombos" border="1">
<tr>
<td>
<B>Export separate types</B>
</td>
<td>
<B>Export individual blocks</B>
</td>
<td>
<B>Material per family</B>
</td>
<td>
<B>Split by block type</B>
</td>
<td>
<B>Effect on objects</B>
</td>
<td>
<B>Material library produced for mosaics (only!)</B>
</td>
</tr>

<tr>
<td>
SELECTED
</td>
<td>
unchecked
</td>
<td>
SELECTED
</td>
<td>
unchecked
</td>
<td>
Polygons are grouped by block family. For individual textures, one group is made for Grass, one for Stone that includes both the stone and granite blocks. Similarly, for mosaics, result is one Grass_Block group using the Grass_Block material applied to 8 block faces (the visible faces of the two grass blocks) and one Stone group using the Stone material applied to 14 faces (the visible faces of the four stone-related blocks, Stone and Diorite).
</td>
<td>
Each block <i>family</i> has a separate material. Result is two materials for mosaics, Grass_Block and Stone.
</td>
</tr>

<tr>
<td>
SELECTED
</td>
<td>
unchecked
</td>
<td>
SELECTED
</td>
<td>
SELECTED
</td>
<td>
<b>Default for rendering:</b> Polygons are grouped by block type. For individual textures, there are three groups: Grass_Block, Stone, and Diorite. For mosaics, result is one Grass_Block group using the Grass_Block material applied to the 8 visible block faces, one Stone group using the Stone material applied to the 6 visible faces, and one Diorite group using the Diorite material applied to its 8 visible block faces. 
</td>
<td>
Each block <i>type</i> has a separate material for mosaics. Result is three materials: Grass_Block, Stone, and Diorite.
</td>
</tr>

<tr>
<td>
SELECTED
</td>
<td>
unchecked
</td>
<td>
unchecked
</td>
<td>
unchecked
</td>
<td>
Polygons are grouped by block family. For individuals, since "Material per family" does not affect export in this mode, the result is the same as two rows above: one group is made for Grass, one for Stone that includes both the stone and granite blocks. For mosaics, result is one Grass_Block group with 8 visible block faces and one Stone group with 14 visible faces.
</td>
<td>
Single material for mosaics. A default MC_material is created and applied to all polygons.
</td>
</tr>

<tr>
<td>
SELECTED
</td>
<td>
unchecked
</td>
<td>
unchecked
</td>
<td>
SELECTED
</td>
<td>
Polygons are grouped by block type. For individuals, since "Material per family" does not affect export in this mode, the result is the same as two lines above: three groups, Grass_Block, Stone, and Diorite. For mosaics, the result is one Grass_Block group with 8 visible block faces, one Stone group with 6 visible faces, and one Diorite group with 8 visible block faces.
</td>
<td>
Single material for mosaics. A default MC_material is created and applied to all polygons.
</td>
</tr>

<tr>
<td colspan="4">
</td>
</tr>


<tr>
<td>
unchecked
</td>
<td>
unchecked
</td>
<td>
(grayed out)
</td>
<td>
(grayed out)
</td>
<td>
<B>Default for 3D printing:</B> No groups are created at all. Result is 22 visible block faces.
</td>
<td>
Single material for mosaics. A default MC_material is created and applied to all polygons.
</td>
</tr>


<tr>
<td colspan="4">
</td>
</tr>

<tr>
<td>
unchecked
</td>
<td>
SELECTED
</td>
<td>
SELECTED
</td>
<td>
unchecked
</td>
<td>
Each individual block is in its own group. Result is 6 block faces in each of six groups (the six blocks): block_00001, block_00002, etc. For mosaics, the related material <i>family</i>, Grass_Block or Stone, is assigned to each block in turn.
</td>
<td>
For mosaics, each block <i>family</i> has a separate material. Result is two materials, Grass_Block and Stone.
</td>
</tr>

<tr>
<td>
unchecked
</td>
<td>
SELECTED
</td>
<td>
SELECTED
</td>
<td>
SELECTED
</td>
<td>
Each individual block is in its own group. Result is 6 block faces in each of six (block) groups: block_00001, block_00002, etc. For mosaics, the related material <i>type</i>, Grass_Block, Stone, or Diorite, is assigned to each block in turn.
</td>
<td>
For mosaics, each block <i>type</i> has a separate material. Result is three materials, Grass_Block, Stone, and Diorite.
</td>
</tr>

<tr>
<td>
unchecked
</td>
<td>
SELECTED
</td>
<td>
unchecked
</td>
<td>
unchecked
</td>
<td>
Individual blocks are output, but grouped by block family. Result is one Grass_Block group and one Stone group. For mosaics, the Grass_Block material is applied to two blocks' 12 block faces and the Stone material is applied to four blocks' 24 faces.
</td>
<td>
For mosaics, each block <i>family</i> has a separate material. Result is two materials, Grass_Block and Stone.
</td>
</tr>

<tr>
<td>
unchecked
</td>
<td>
SELECTED
</td>
<td>
unchecked
</td>
<td>
SELECTED
</td>
<td>
Individual blocks are output, but grouped by block type. The result is three groups: Grass_Block, Stone, and Diorite. Mosaics have the Grass_Block material applied to two blocks' 12 block faces, the Stone material applied to two blocks' 12 faces, and the Diorite material applied to two blocks' 12 block faces.
</td>
<td>
For mosaics, each block <i>type</i> has a separate material. Result is three materials, Grass_Block, Stone, and Diorite.
</td>
</tr>

</TABLE>
<P>
When exporting <B>individual textures</B> these settings have slightly different meanings, because separate materials are created depending on the texture needed, not the Minecraft block family or type. "Export individual blocks" then means that "Split by block type" has no effect, since materials are set as needed. Similarly, if neither "Export separate types" nor "Export individual blocks" is on, materials are output as needed, since there can be no "single material for all" with "individual textures." Long and short: try various options out and see what they do.

<P>
<b><a id="make_groups_objects">Make groups objects:</a></b> By default, the OBJ file produced has just one object, consisting of everything exported. If you want to make each group into its own separate object, which can be useful if you are trying to <a href="#individual">export individual blocks</a> and animate them in the scene, check this box. This is useful in Blender, for example.

<a id="full_material"><H4>Custom material</H4></a>

Checking this box causes a more elaborate illumination model to be output for OBJ (see <a href="#usd_export_options">the USD documentation</a> for its effect with that format). By default it is checked, so that a more elaborate material model is used. Specifically, the parameters Ns, Ka, map_Ka, illum, and Tf are set. Also, a special mode is exported for use by G3D: "interpolateMode NEAREST_MAGNIFICATION_TRILINEAR_MIPMAP_MINIFICATION". This hints to G3D to make the textures look blocky, giving the classic Minecraft look. This line should not hurt OBJ readers, which should simply ignore it (or possibly flag a warning).
<P>
If you are using a <a href="textures.html">physically based terrain set</a>, the custom material will also include additional channels of information, such as textures for normal maps, shininess power, metallic, and emission textures. These attempt to follow <a href="http://exocortex.com/blog/extending_wavefront_mtl_to_support_pbr">this proposed specification</a>, also documented <a href="https://en.wikipedia.org/wiki/Wavefront_.obj_file#Physically-based_Rendering">here</a>. An example:
<UL>
<LI>map_Kn block_world_tex/redstone_torch_n.png - the RGB normals map (<I>not</I> a heightmap, so "bump" or "norm" is not used)
<LI>norm block_world_tex/redstone_torch_n.png - an alternate way to attach the normals texture
<LI>map_Pm block_world_tex/redstone_torch_m.png - the grayscale metallic texture
<LI>map_Ke block_world_tex/redstone_torch_e.png - color texture for the illuminant parts of the model
<LI>map_ns block_world_tex/redstone_torch_s.png - the grayscale specular power texture, 0-255
<LI>map_Ns block_world_tex/redstone_torch_s.png - an alternate way to attach the specular power texture
</UL>
If you want to use the custom material description for OBJ export but do not want these additional textures to be output, simply delete or rename the images in the set that you want to remove. For example, with the terrainExt_JGRTX64*.png set of terrain files, removing terrainExt_JGRTX64_e.png means no grayscale intensity emissive textures will be output. You may also find that the corresponding color texture is a better choice for the emissive texture in particular, if supported - this is true for the G3D viewer. Currently Mineways has no switch to use these colored textures instead. However, you can edit the MTL file produced and simply search for "_e.png" and replace with ".png" to point to the colored textures instead.

<P>
Special note: in terrain files, the one ending in "_r.png" is a roughness texture. When exported for OBJ, this texture is inverted and the exported files are named "_s.png", for "specular". This is all a bit confusing, I know, but my advice is to export using terrainExt_JGRTX64.png, for example, and see what gets created for you, with "Custom material" set or not. If you want the "r" version, you can either manually invert the _s.png images (ugh), or just do a separate USDA export, which will produce the _r.png versions.


<a id="usd_export_options">
<H4>Pixar USD File Export Options</H4></a>

<a href="https://graphics.pixar.com/usd/release/index.html">Pixar's USD format</a> is getting uptake in many popular digital content creation (DCC) applications, including Cinema 4D, Houdini, Unreal Editor, and Blender. It is more full-featured than the ancient Wavefront OBJ format, including direct support for physically based materials, emitters, and more. If your package of choice supports it, consider using it!

<P>
There are a few changes to how the export dialog works. Some export options are not supported, as the focus has been the highest-quality and more flexible export option: Export individual textures. This form lets you replace and edit individual texture files. USD export works particularly nicely with the JG-RTX terrain files.

<P>
What follows are how various options apply to USD export. Also, Mineways' "View | Light" can be toggled on to give nighttime lighting. Turning "View | Elevation shading" on will give a light fog to the USD scene exported.

<P>
<B>Export individual blocks:</B> With USD export, two additional USD files are produced, "*_BlockLibrary.usda" and "*_MaterialLibrary.usda". USD structures its data in different forms. These additional files contain the individual blocks and materials, in case these are of use as-is.

<P>
<B>Export MDL:</B> Applies only to USD export. <a href="https://www.nvidia.com/en-us/design-visualization/technologies/material-definition-language/">MDL material descriptions</a> are exported. These generally give higher-quality looks to glass objects, for example. <a href="https://www.nvidia.com/en-us/omniverse/apps/create/">Omniverse USD Composer</a> is the main user of MDL at this point, with other applications coming up to speed. Turning this off will export only <a href="https://graphics.pixar.com/usd/release/wp_usdpreviewsurface.html">UsdPreviewSurface material descriptions</a>. Note that UsdPreviewSurface descriptions are always exported.

<P>
<B>Custom material:</B> This option is ignored if Export MDL is off. For USDA export, the Custom material setting mainly has the effects of making the texture's texels appear blocky, in Minecraft fashion, and present stripped down materials in <a href="#ovcreate">Omniverse USD Composer</a>. I uncheck this box for higher-resolution resource packs (basically 64x64 or larger tiles) so that the textures interpolate more smoothly. This option is also discussed in <a href="https://youtu.be/lpFpj84eFgw">this video</a>.

<P>
<B><a name="opt_lighting">Light scale:</a></B> Used only by USD. This has a value of 30 by default. You can change the intensity of the lights exported to USD - the sun and dome light - by changing this value. The sun is normally at 30, the surrounding dome light is 6. Nighttime lighting of 2 and 2 respectively, is used if you toggle on the View | Lighting option before export. If you set the light scale to 0, the two lights will not be exported to the USD file <I>and</I> the default camera will also not be exported.
<P>
As of August 2023 lighting in the USD specification is not well defined, meaning programs will be (sometimes radically) different in their interpretation of intensity values. Currently "30" means a value of 1560 for the sun and 312 for the dome light. These work well with Omniverse's USD Composer and the upcoming Blender 4.0.0 release. For the UsdView viewer, I have found that 40,000 and 0.5 are better values, respectively. Since light scale is one control for two intensities, you will likely need to hand-edit the resulting USDA file to such values. Alternately, set the scale to 0 and no lights are output.

<P>
<B>Surface emit scale:</B> Used only by USD. This has a value of 1000 by default. It's more or less a <a href="https://en.wikipedia.org/wiki/Candela_per_square_metre">nit</a> value for emitting surfaces. Omniverse USD Composer looks good with the default, though realistically the emitters are then quite bright (but look good for interior scenes or when the sun is turned off). Adjusting the camera exposure is another way to deal with this situation.
<P>
The default of 1000 converts to an internal value of 20.0 for inputs:scale. For UsdView this can give a washed out look; a value of 50 may be more appropriate.


<a id="opt_globals">
<H3>Global Model Options</H3></a>
A few options change how blocks' coordinates and textures are output. If you want to change the overall scale of the model, use the <a href="#opt_size">"Make each block" option</a> in the upper right of the dialog.

<a id="simplify">
<H4>Simplify mesh</H4></a>

This option merges neighboring squares to create larger rectangles. This can significantly reduce the model's size. However, it has the drawback of turning off randomized texture rotation. Normally grass and other blocks are rotated randomly by Mineways (and Minecraft) to break up the patterned look of a single texture being repeated over a large area. Simplify mesh is only available when exporting individual textures (but not individual blocks) for OBJ and USD export, and only for rendering. It is not available for 3D printing, as doing so can cause T-junctions, which can in turn cause 3D printers to fail. It is also currently not available for untextured model export, since there are better simplification systems available (some of which do work better for 3D prints), such as <a href="https://meshmixer.com/">Meshmixer</a>, <a href="https://www.meshlab.net/">MeshLab</a>, and <a href="https://docs.blender.org/manual/en/latest/modeling/modifiers/generate/decimate.html">inside Blender</a>.

<P>
Here is a side by side comparison of a mesh's look normally and simplified, without and with wireframe for the grass. This (admittedly near-optimal for simplification) export from the built-in "[Block Test World]" went from 142,428 to 15,726 triangles when simplified. Note the pattern repetition on the grass in the upper right.
<P>
<img src="images/simplification.jpg">

<a id="composite">
<H4>Create composite overlay faces</H4></a>

For 3D printing there cannot be "floating" cutout textures such as vines, ladders, rails, torches, and so on. These block types are overlaid atop the underlying block and a new "composite" texture is saved and used. This process must be done for 3D printing. For rendering with mosaics it is an option. The advantage of leaving this option off is that the result more closely matches Minecraft itself, and that each object has its own material. It also means that all render files exported could use single set of PNG textures, since no composite textures are created. The main drawback of having this option off is that you may encounter z-fighting problems, stray shadows, or other artifacts in your renderings.
<P>
This option was on by default for rendering up to version 5.00 of Mineways (in truth, it could not be turned off); as of 5.01 this option is off by default.
<P>
<div id="textureImgsSet">
  <div id="textureImgs">
    <div class="textureImg">
      <img src="images/composite_off.jpg" alt="composite off">
      <span class="caption">Create composite option off (the default). The ladders, rails, and lily pad float a bit above the surface.</span>
    </div>
    <div class="textureImg">
      <img src="images/composite_on.jpg" alt="composite on">
      <span class="caption">Create composite option on. Note how the ladders, rails, and lily pad are attached to the surface.</span>
    </div>
  </div>
</div>


<a id="center_model">
<H4>Center model around the origin</H4></a>

When checked, the center of the bottom of the model is put at the origin, location (0,0,0). This helps for import into some renderers, and can improve the floating-point resolution of the data. If you want to instead have the same coordinate values as in your world, uncheck this box (you might also want to set <a href="#opt_size">the "Make each block" size</a> to whatever you like). Unchecking this option is useful if you do multiple exports from the same world for rendering and want them to use the same coordinate space. Multiple exports are a way to get around the export size limits for the 32-bit version of Mineways, which is what runs on the Mac.

<a id="biome_center">
<H4>Use biome in center of export area</H4></a>

Instead of the default colors (seen on the <a href="http://minecraft.wiki/w/Biome">Plains biome</a>), use the grass, tree, and water colors computed by the biome in the export. Currently the biome at the center of the export is used for the whole export. It would be nice to export multiple biomes someday, but this is a complex export, as it can require many different color variants of grass and tree blocks. Show biomes (F8) to display the biomes in the map itself.

<a id="border_faces">
<H4>Create block faces at the borders</H4></a>

This option is only available for rendering, to reduce polygon count. When on, the edges of the export the model are sealed off with whatever blocks were at the borders. For 3D printing this is necessary, as the model must be a solid object. For rendering these side and bottom polygons often are not needed, as the camera is usually positioned to never view these areas of the model. Turning this option off for rendering also allows better "tiling", where you export a world piece by piece and read all the pieces in (see <a href="#center_model">center model</a>, above), as it pays more attention to neighboring blocks just outside the borders. Note: the various 3D print "fill air bubbles" methods will turn off this method (it's a bug).
<P>
In the scene below, the camera is dollied out to see the borders. The model with borders off, on the right, has about 15% less polygons in it.
</P>
<div id="terrainExtImgs">
  <img src="images/borders_on.jpg">
  <img src="images/borders_off.jpg">
</div>

<a id="leaves_solid">
<H4>Tree leaves solid</H4></a>

This option is only available for rendering, to reduce polygon count. Tree leaves are "cutout" textures, which means that by default each leaf block is exported, along with the trunks. In forested scenes this can make for a lot of extra polygons. By checking this box, leaves are made solid with a black background, which then allows many less polygons to be generated. For example, in the scene below, rendered with <a href="#g3d">G3D</a>, the transparent leaf model has 986k triangles, the solid leaf model just 369k triangles.
</P>
<div id="terrainExtImgs">
  <img src="images/trees_transparent.jpg">
  <img src="images/trees_solid.jpg">
</div>

<a id="rotate_model">
<H4>Rotate model clockwise</H4></a>

Can be useful for choosing a default view angle for other programs reading in the model produced. For example, the view of the model is rendered by Shapeways from the south-south-east. So if your model faces west, you might rotate it 270 degrees to have it face south and so display better on your models page.

<P>
The rest of the options mostly have to do with 3D printing, which follows. The main exception is <a href="#opt_size">"Make each block 1000 mm high"</a>, which can be used to change the size of the model output.


<HR>
<H3 id="print">
Exporting to 3D print
</H3>

As background, view the <a href="http://www.youtube.com/watch?v=hHxp9Ail6MY&feature=player_embedded">Shapeways 3D color printing process video</a>. Layers of material are laid down and solidified at the appropriate spots. Unsolidified "sand" is vacuumed away. You pay by volume, not by complexity. What this means to you is: avoid making enclosed spaces with tiny entrances. Unfortunately, most buildings are just that: large rooms with small doors. Your job is to make sure your model has either no openings at all, in which case the Hollow option can clear out the inside, leaving just a shell. Alternately, make escape holes yourself using snow blocks, which you then melt after all processing of your model. I'll explain these options below.
<P>
There are other potential pitfalls with 3D printing, such as <a href="http://www.shapeways.com/tutorials/3dprintingminimumwallthicknesstutorial">thin wall problems</a> (more <a href="http://www.shapeways.com/tutorials/thin_walls_tutorial">here</a>), and <a href="https://support.shapeways.com/hc/en-us/sections/360004437873-Software-Tutorials">too many polygons</a> (rare for a Minecraft model), to name just two. Shapeways' <a href="https://support.shapeways.com/hc/en-us/categories/360001855814-Tutorials">tutorial pages</a> and <a href="https://support.shapeways.com/hc/en-us/sections/360003550794-Materials">materials pages</a> give you a lot to chew on, <a href="http://www.sculpteo.com/en/help/">Sculpteo</a> also has a help section. The Mineways program tries to guide you past the major pitfalls, but it's always possible to generate something that's essentially unprintable: too weak, holes too small to clear out the dust, or some other problem. Browsing the tutorials there should help you understand what is possible. <a href="https://www.reddit.com/r/3Dprinting/comments/13u0boy/printing_my_mc_world_with_mineways/">This post</a> might help you with 3D printer settings. Options follow.
<P>

<a id="z_up">
<H4>Make Z the up direction instead of Y</H4></a>
Z up is the norm for 3D printing. Some graphics applications consider the Y direction to be "up", some Z. If your model imports sideways into your application, check (or uncheck) this box.

<H4 id="opt_size">
Model Size
</H4>

There are four major ways to set your model's size.
<ul>
<li>Make the model #N cm high: you can specify how high you would like a model to be. This is also useful for rendering output, where the default is set to be reasonable for import into Blender.
</li><li>Minimize size based on wall thickness: if you want to make "draft" 3D print models that are as small as safely possible, check this option. That said, if you know your model has thick walls, you could make your model smaller still by using the next option.
</li><li>Make each block #N mm high: by default, the safe wall size (for a non-supporting wall) is shown here. You can make this value smaller if you are convinced that your model is thick enough to print. Mineways will issue a warning nonetheless. This option is also useful for rendering output. Note for pixel-art makers: if you export pixel art, the thickness of pixel art model is usually just one block wide. Shapeways won't print a model in colored sandstone that is less than 2 mm thick, so use the "Make each block" option and set it to 2.5 mm high.
</li><li>Aim for a cost of #N: you can ask, though the wall size needed may be too small to safely print. If you get this warning on export, you'll have to decide whether the walls appear thick enough to print. This feature is imperfect: it computes a rough cost before hollowing, so that it has a sense of how small it has to make the blocks to reach the goal. Hollowing uses this size to keep the walls thick enough to print. So, sometimes the walls are thicker than needed when the model is finally exported.
</li></ul>
<P>
<B>Physical material:</B> choosing a material here from among some of the <a href="http://www.shapeways.com/materials/">Shapeways material options</a> sets the default wall thickness and constrains the "Aim for a cost" option. It also ensures that the price is computed for that material and output in the top of the model file (or associated *.txt file, for STL output). <b>Key tip:</b> if you look at the export file Mineways creates for you (the .OBJ, .WRL, or for STL the .TXT file) in a text editor, at the top you'll find all sorts of useful information about the model and how you generated it.
<P>
The "White &amp; Flexible" material has a smaller minimum wall thickness compared to "Colored Sandstone" (0.7 mm vs. 2.0 mm), so much smaller (and cheaper) models can be created in it. White &amp; flexible is plastic and durable, colored sandstone is heavier, <a href="http://www.youtube.com/watch?v=o-yeV4tTTKE">fairly strong, but brittle</a>. Shapeways has <a href="https://support.shapeways.com/hc/en-us/articles/360033930173-Cleaning-and-painting-Fine-Detail-Plastic-models">a tutorial on how to paint this white plastic material</a>, which can be fun in itself. Note that the <a href="https://www.shapeways.com/materials">ceramics material</a> has a <i>maximum</i> wall thickness of 15 mm, something Mineways does not check; this material is also the only one where you are charged by surface area instead of volume (which Mineways does compute).
<P>
The "Custom Printer" material is used for STL export. By default, it is set to show the approximate cost of a print for 1.75 mm PLA priced at $24 for a 1 kilogram spool. The cost numbers are modifiable by using a script. See the <a href="scripting.html#soc">scripting commands for "Custom printer"</a> for how to set new cost values.
<P>
<B>Model's units:</B> when a model is saved, the values stored in the file are not in any particular units, like meters or inches. However, 3D printers need this scale for printing the model. Millimeters are assumed, as this is what Shapeways uses by default. For other services and printers, other units are assumed. Here's a brief rundown:
<UL>
<LI><a href="http://sculpteo.com/">Sculpteo</a> - choose the "Wavefront OBJ, absolute and true" file type; by default, "Z is up" is on and the units are centimeters. Textured models are fully supported, including the truly worthwhile <a href="#lesser">"Export lesser blocks"</a> feature, though <a href="#lesser">read the warnings</a> to make sure you know what problems may occur.
<LI><a href="http://i.materialise.com/">i.materialise</a> - for this 3D print service, millimeters are the default units. For STL export, choose the "Binary Materialise Magics" STL file type; by default "Z is up" is off and the units are millimeters. Textured models are not currently supported, but colored models are, by exporting color to STL and choosing the multicolor material in their 3D print lab. If you want to import VRML for some reason, "Z is up" should be on and you'll have to change the export scale to millimeters.
<LI><a href="http://ponoko.com">Ponoko</a> - this 3D print service uses centimeters, millimeters, and inches. "Z is up" should be on, to show properly in Ponoko's thumbnail view. If your model is flagged as having a problem with normals, export again and check the "Weld all shared edges" checkbox. You can use the "Export solid material colors" or "no materials" options; textures are not supported. The preview itself will not show the colors, but I have been assured the model will print with color.
<LI><a href="http://reprap.org/wiki/RepRap">RepRap</a> - this home 3D printer <a href="http://repraprip.blogspot.com/2012/01/tutorial-printing-from-minecraft-with.html">appears to need models in centimeters</a>. I'm not sure if this is more of a requirement of the related software.
</UL>

<H4 id="opt_fill">
Filling and Hollowing Options
</H4>

By default, the model is heavily processed to clear up a number of potential 3D printing problems:
</p>
<P>
<b>Fill air bubbles:</b> any hollow volume is filled with solid material (specifically, glass, which can sometimes be seen when doing base hollowing, below). This option can also potentially reduce the polygon count when exporting for rendering - YMMV. There are two sub-options: 
<ul>
<li id="seal">Seal off entrances: If a building has 1-block wide windows and doors that are not filled in, this setting will attempt to fill these in with recessed glass blocks. This option also uses snow blocks and "entrance" blocks - doors, ladders, trapdoors, torches, fence gates, daylight sensors - to help seal off rooms, even if the doors and ladders themselves are culled. See the examples below. Sealing a room has a few advantages: the interiors of rooms that cannot be seen are filled in. This lets <a href="#hollow">the hollowing option</a> do its job better, both saving material on a print and making the print stronger.
</li>
<li>Fill in isolated tunnels: a volume being exported can have tunnels underground running through it, and can run into the sides of the volume itself. These tunnels cost time and money to print; if the tunnel is isolated (no access to the surface) then this option will seal these off and fill them in. Hollowing can then remove more material.
</li>
</ul>
<P>
<b>Example:</b> in the first image, the inside of the building is not filled in. In the second, the "Seal off entrances" export box is checked. Since the model has window and door gaps that are only a block wide, these will be detected and the interior will be filled in with glass to cover these openings, as shown on the right.
<P>
<img src="images/no_seal_doors_windows.jpg">
<img src="images/seal_doors_windows.jpg">
<P>
<b>Wide door example:</b> in the first image, the inside of this simple building is visible. In the second, the "Seal off entrances" export box is checked. The torches are then considered as blocking the entrance; since the entrance is fully sealed off, the room is filled with glass. This example is trivial, but by placing torches you can seal rooms off so that they fill up with glass, then get hollowed by the "hollow" option, described further on, thus saving on printing areas difficult or impossible to see from outside.
<P>
<img src="images/no_seal.jpg">
<img src="images/seal.jpg">
<P>
<b>Another wide door example:</b> Another way to seal off large doors or windows is to add snow blocks. Here a two-block-wide door will not automatically be sealed off by the "seal off entrances" option. By adding snow blocks and then also enabling the <a href="#melt">melt option</a> (and turning off the <a href="#hollow">hollow option</a>), the building interior will be sealed off and then the snow blocks will be removed before output.
<P>
<img src="images/no_seal_without_snow.jpg">
<img src="images/seal_with_snow.jpg">
<img src="images/seal_with_snow_melted.jpg">
<P>
<b><a name="opt_connect">Connect parts sharing an edge:</a></b> certain <a href="https://support.shapeways.com/hc/en-us/articles/360007107674-Tips-for-successful-modeling">non-manifold edges</a> (where two blocks are diagonal and share an edge) are eliminated by a welding process in which more blocks are added. This welding process normally occurs only when it joins pieces that otherwise would be separated and fall apart.
<ul>
<li>Connect corner tips: if two blocks touch at just their tips and the blocks are found to be in separate parts, they are then welded together by adding two new blocks.
</li>
<li>Weld all shared edges: Shapeways normally allows two blocks' edges to touch, despite <a href="https://support.shapeways.com/hc/en-us/articles/360007107674-Tips-for-successful-modeling">information to the contrary</a>. If this behavior is unacceptable (Shapeways or some other application rejects the model), checking this box will work to remove all shared edges.
</li>
</ul>
<div id="connectBlocksSet">
  <b>Example:</b>
  <div id="connectBlocks">
    <div class="connectBlock">
	  <img src="images/balloons1.jpg">
      <span class="caption">With all connect parts options off the strings of the balloons do not connect. These will probably print as separate bits.</span>
    </div>
    <div class="connectBlock">
      <img src="images/balloons2.jpg">
      <p class="caption">Blocks sharing an edge are connected. Some parts of the strings touch only at corner tips, so are still not connected. Note that for these examples the "delete floating objects" option was turned off, as otherwise the disconnected string bits would have been removed.</p>
    </div>
    <div class="connectBlock">
      <img src="images/balloons3.jpg">
      <p class="caption">Corner tips are connected, and now each balloon will print correctly.</p>
    </div>
    <div class="connectBlock">
      <img src="images/balloons4.jpg">
      <p class="caption">Debug mode, showing edge connecting blocks as lava and tip connecting blocks as pink wool.</p>
    </div>
  </div>
</div>
<P>
<b><a name="opt_floating">Delete floating objects:</a></b> if objects hang in space, these are eliminated if they're small (less than 16 blocks in size) or are entirely tree logs and leaves. This step eliminates parts of trees hanging along the edge because of where the selection box is located. If you get a warning about there being more than one part in a model exported, crank the block number up to 1000 or more to get rid of larger chunks (once you know what those chunks are - see the debug display parts mode below). If you're sure you want just the one connected group in the scene, set this value to 999999 and only the largest object in the scene will be saved.
<P>
This option can help tidy up a model for rendering or Sketchfab, too, by deleting tree foliage poking into an exported volume. In these export modes, any adjacent blocks are joined up (for 3D printing, only blocks that fill the cell are joined together). This difference means that, for example, a roof supported by fence posts won't be considered floating when rendering, but will when using detailed 3D printing (as the fence supports would likely be too thin to hold the roof).
<P>

<div id="floatingBlocksSet">
  <b>Example:</b>
  <div id="floatingBlocks">
    <div class="floatingBlock">
	  <img src="images/adobe1.jpg">
      <span class="caption">Exporting without deletion of floating objects results in a hunk of foliage hanging in space.</span>
    </div>
    <div class="floatingBlock">
      <img src="images/adobe_debug.jpg">
      <p class="caption">The "debug showing groups" option shows the disconnected group (the black columns are support columns created when hollowing).</p>
    </div>
    <div class="floatingBlock">
      <img src="images/adobe2.jpg">
      <p class="caption">Turning on deletion of floating objects, the floating foliage is deleted. Note the clump of leaves from a chopped-off tree stuck to the house is not deleted: get out the shears in Minecraft, if you want to chop it clear.</p>
    </div>
  </div>
</div>

<P>
<b id="hollow">Hollow out bottom of model:</b> models are typically resting on an uneven ground layer, and building interiors are typically filled in. Hollowing clears out blocks inside the model, making it <a href="http://www.shapeways.com/tutorials/creating-hollow-objects">less expensive</a> and faster to print. The "super hollow" option is more aggressive, searching hollow areas found to see if more can be carved out.
<P>
This option, used in conjunction with <a href="#seal">seal off entrances</a>, can make detailed models stronger. If the interior of a model is entirely filled in by the "fill air bubbles" process, it can then be hollowed out and the walls left thick. For example, say you want to print your cathedral model with 1 mm wide blocks. The printer you want to use needs walls at least 2 mm thick. Instead of manually adding blocks to the interior of your entire model, by using the seal off the entrances option you fill the interiors in with solid blocks. When you hollow, you set the hollow width to 2 mm, or even 3 mm, and now the exterior walls will be made a few blocks thick, automatically.
<P>
Technical note: superhollow can sometimes create little separate objects at the bottom layer unconnected to the rest of the model, pieces of tunnel not cleaned out. You'll need to also turn on the "fill in isolated tunnels" box to have these removed ("delete floating objects" should do this, but currently does not).
<P>
<div id="hollowBlocksSet">
  <b>Example:</b>
  <div id="hollowBlocks">
    <div class="hollowBlock">
	  <img src="images/teapot1.jpg">
      <span class="caption">Hollowing is off and tunnels are not sealed.</span>
    </div>
    <div class="hollowBlock">
      <img src="images/teapot2.jpg">
      <p class="caption">Tunnels are sealed (the glass blocks). While this briefly increases the block count, hollowing will cut it considerably.</p>
    </div>
    <div class="hollowBlock">
      <img src="images/teapot3.jpg">
      <p class="caption">Basic hollowing is performed; the cutaway shows how far it penetrates into the teapot. Block count is reduced from 26.8k blocks to 14.7k blocks.</p>
    </div>
    <div class="hollowBlock">
      <img src="images/teapot4.jpg">
      <p class="caption">Superhollowing is performed, reducing the count further, to 8.3k blocks. The escape hole between teapot and ground looks to be large enough to clear the sand (and indeed it was, see <a href="images/teapot_bottoms.jpg">this photo</a>)</p>
    </div>
  </div>
</div>

<P>
<b id="melt">Melt snow blocks:</b> The <a href="#seal">seal off entrances option</a> automatically looks for one-block-wide entrances and windows and seals them off. If you have wider entrances, off-axis windows (such as in a dome), holes in the roof, or other features, instead of adding torches or ladders to help seal these off, you can use snow blocks to do so. The melt option then removes these snow blocks from your model just before output. See the <a href="#seal">seal off entrances option</a> description for an example of its use.
<P>
<b id="lesser">Export lesser, detailed blocks:</b> when 3D printing, this option is off by default; for rendering it is on. When not checked, smaller objects, such as signs, fences, and torches are removed - only nearly-block-sized or important blocks are exported. This option is on by default when exporting full color textures for rendering; turn it off to remove the "billboard" objects and other smaller geometry objects. Remember you can also turn off output of any block type by setting its alpha to zero in your own custom <a href="#schemes">color scheme</a>. I've given you the ability to shoot yourself in the foot for 3D printing; I leave it to you to turn off any block types you think are likely to break off. As such, if you use this option you should probably turn off the "Connect parts sharing an edge" and "Delete floating objects" options further down, as these are likely to not work well - only full blocks are tracked when using these features. When exporting lesser blocks it's better to add and delete blocks by hand and not have the program clean up the data. If you do want to check for floating objects, I recommend exporting full blocks first (which will perform the check properly if the option is checked), then export lesser blocks with the option off.
</P>
<P>
Checking this box for 3D printing is risky, but will allow you to export slabs, stairs, and many other smaller elements as true geometry. <a href="#fullBlocksTable">The table</a> gives specifics about what is printable, under the "Lesser" column. The model produced with this option on can have some geometry that's tough for some 3D print slicers to process. The risk is that the service bureau or printer software cannot properly interpret your files. If you are printing a single-color model, use the free <a href="https://service.netfabb.com/login.php">cloud version of netfabb</a> to preprocess your model. Shapeways also uses <a href="https://www.autodesk.com/products/netfabb/overview">netfabb</a> to process your uploaded models, so you should have no problems with the mesh itself using their service. You may still have problems with features being too thin to reliably print. If you truly want to print some geometry that Mineways won't output for 3D printing, e.g., you want to make a large banner model, you can always export via rendering and perform cleanup yourself (such as removing billboards).
<P>
If you use another service bureau such as Sculpteo, look over your uploaded model for any missing block or texturing errors (well, as of 2021, Sculpteo does not support textured, colored output). Secret <a href="http://sculpteo.com">Sculpteo</a> trick: you can see a large view of your model by using the URL http://www.sculpteo.com/en/embed/design/&lt;xxx&gt;, where you put the 8 character identifier for your model in place of &lt;xxx&gt;. For example, if your URL is <a href="https://www.sculpteo.com/en/print/sand-castle-1/hfM9BZw2?uuid=4OmRAVteIsyb9BYa10KM3b">https://www.sculpteo.com/en/print/sand-castle-1/hfM9BZw2?uuid=4OmRAVteIsyb9BYa10KM3b</a> the 8 characters in the URL are "hfM9BZw2", so use <a href="http://www.sculpteo.com/en/embed/design/hfM9BZw2">http://www.sculpteo.com/en/embed/design/hfM9BZw2</a> to see it large. (Sadly, I can't figure out how to make these URLs public for anyone to view; Sculpteo seems to have locked that down.)</p>

<div id="slicerProbsSet">
  <div id="slicerProbs">
    <div class="slicerProb">
      <img src="images/shapeways_solamar_compare.jpg">
      <span class="caption"><a href="http://shapeways.com">Shapeways</a> merges most of the "lesser blocks" geometry properly but fails with some textures.</span>
    </div>
    <div class="slicerProb">
      <img src="images/sculpteo_solamar_compare2.jpg">
      <p class="caption"><a href="http://sculpteo.com">Sculpteo</a> does the texture merge properly, but is missing a stair step on the right part of the roof.</p>
    </div>
    <div class="slicerProb">
      <img src="images/sculpteo_stress_small.jpg">
      <p class="caption">Sculpteo's solidity check feature showing how fences along the top of this palace model are likely to break off.</p>
    </div>
  </div>
</div>

<P>
Currently some thin objects, such as sign posts and single fence posts, are exported. These are likely to break off, especially at small block sizes. You might want to "shore up" thin features by placing blocks below them (such as for roofs made of stair steps) and next to them (such as for doors). Alternately, turn off export of signs altogether by setting the alpha for the sign block types to 0 in a <a href="#schemes">color scheme</a>.
<P>
Below are three prints done with fences, stair and slab roofs, and other small blocks. On the left, 1 mm/block, the fences and thin pillars have sheared right off. 2 mm/block, in the middle, survived intact for the most part - not surprisingly, a free-standing door at the rear broke off. With 3 mm/block, on the right, a part of the fence broke off when the superglue was applied. More photos can be found <a href="http://imgur.com/a/kQFPW">here</a>. <I>(Image courtesy of Alex Boden)</I>
<P>
<img src="images/model_sizes.jpg">
<P>
<b id="fatten">Fatten lesser blocks:</b><span> If you do decide to export using the "lesser" option, by default some of the more delicate blocks are made fatter so that they are less likely to break off during printing. No guarantees! The blocks fattened are: fences, fence gates, doors, free-standing sign posts (which I suspect will still snap off), pressure plates (since they sometimes get used for table tops), bells, and a number of others - see <a href="#fullBlocksTable">the table</a>.</span>

<H4 id="opt_debug">
Debugging Visualization
</H4>

There are also two debug print options available. The "Debug: show floating parts" option does just that: the largest object is made semitransparent and smaller groups each given a unique color, so that you can see what pieces of the model are not connected. <a href="#opt_floating">See images here</a>. Either remove these smaller parts by kicking up the "delete floating objects" limit, or go into Minecraft itself and add blocks to attach them together. That said, separate parts are fine in a file if you know what you are doing: you could be making a chain of separate links, or could have a number of individual pieces (such as letters) you want to create in a single print run.
<P>
The "show weld blocks" option shows what blocks are added by the various "connect parts" options. <a href="#opt_connect">See images here</a>. If you don't like where the welds are put, you can go into your Minecraft world and edit the model yourself. <b>Key tip:</b> you can run Mineways and play Minecraft at the same time. So, you can edit your world in Minecraft, then reload the world into Mineways by pressing the "r" key. The selected area won't be cleared when you do so, so you can edit, reload, export, and view the model (in a separate viewer); lather, rinse, repeat. This is an efficient way to improve and view any model you're working on.

<HR>
<H3 id="tilemaker">
ChannelMixer and TileMaker
</H3>
You can make your own sets of textures to use when exporting models with Mineways. This process is fairly straightforward, but is a more advanced topic. See the <a href="textures.html#own_terrain">Textures page</a> for how textures work in Mineways and how to use these tools, or <a href="https://youtu.be/RpN1grOLocg">watch the video</a>.

<HR>
<H3 id="rendering">
Rendering Tips
</H3>
<div id="renderTips">
  <p>
  There are <a href="https://www.pcgamer.com/best-minecraft-shaders/">lots of cool add-on shaders</a> for Minecraft.
  But, for truly stunning stills and animations you'll want a standalone package.
  This section covers the basics on importing Mineways files into various renderers:
  <a href="#blender">Blender</a>,
  <a href="#c4d">Cinema 4D</a>,
  <a href="#ovcreate">Omniverse USD Composer</a>,
  <a href="#3dsmax">3DS MAX</a>,
  <a href="#maya">Maya</a>,
  and <a href="#houdini">Houdini</a>.
  If you want better geometry for some blocks, you might also consider using <a href="https://www.jmc2obj.net/">jmc2obj</a>. Honestly, they have a lot of features Mineways doesn't, so you should give it a try.
  <P>
  While I have your ear (eye?), you should also check out the shader mods <a href="https://bitslablab.com/bslshaders/">BSL</a>, <a href="https://rre36.com/kappa-shader">Kappa</a>, <a href="https://www.minecraftforum.net/forums/mapping-and-modding-java-edition/minecraft-mods/1272953-optifine-hd-fps-boost-dynamic-lights-shaders-and">OptiFine</a>, and <a href="https://www.sonicether.com/seus/">Sonic Ether's Unbelievable Shaders</a> (<a href="https://www.minecraftforum.net/forums/mapping-and-modding-java-edition/minecraft-mods/1280299-sonic-ethers-unbelievable-shaders-compatible-with">SEUS forum</a>) for in-game play or viewing. They have lots of cool rendering options. What makes these systems shine (literally) is using a high-quality texture pack that support specular textures, bump maps, etc. Some nice texture packs: <a href="https://github.com/jasonjgardner/jg-rtx">JG-RTX</a>, <a href="https://umsoea.com/">UMSOEA</a> and <a href="https://sildurs-shaders.github.io/downloads/">Sildur's Shaders</a>, among many others (<a href="https://www.planetminecraft.com/texture-packs/tag/bsl/">BSL search</a>).
  <P>
  Also worth a shout-out, the <a href="https://www.nvidia.com/en-us/geforce/news/minecraft-with-rtx-beta-out-now-download-play/">Minecraft RTX beta</a>. If you have an RTX card, this system accelerates ray tracing effects on the Bedrock Edition (sorry, no Java Edition version). However, conversion of a Java Edition world is fairly straightforward; they give <a href="https://www.nvidia.com/en-us/geforce/guides/minecraft-rtx-world-conversion-guide/">a long guide</a>, but really, just follow the <a href="https://www.nvidia.com/en-us/geforce/guides/minecraft-rtx-world-conversion-guide/#textcomponentenhance_16365283995c6722f5_46dd_4cdd_ba02_77ef3ae0242d">MCC Tool Chest Conversion</a> steps - it's all I needed (note that MCC Tool Chest has, sadly, disappeared, but can be found archived <a href="https://web.archive.org/web/20210513191001/http://www.mcctoolchest.com/Download">here</a>). If you're really feeling frisky, you can <a href="https://www.nvidia.com/en-us/geforce/guides/minecraft-rtx-texturing-guide/#resource-pack-setup">design a texture pack</a> (though be warned, <a href="https://help.minecraft.net/hc/en-us/articles/360042255511">the format will change</a>).
  <P>
  <h4 id="previewing">Previewing:</h4>
  <p>To quickly check results before printing or importing into a rendering program, consider using an interactive previewer. The <a href="#g3d">G3D viewer</a> is great for OBJ files, with shadows and screenshot capture built in. <a href="https://en.freedownloadmanager.org/Windows-PC/Open-3D-Model-Viewer-FREE.html">Open 3D Model Viewer</a> mostly works, though has transparency issues when you export individual textures. <a href="https://www.microsoft.com/en-us/p/3d-viewer/9nblggh42ths?activetab=pivot:overviewtab">Microsoft's 3D Viewer</a> also can work, though it does not treat semitransparent surfaces well. <a href="http://meshlab.sourceforge.net/">MeshLab</a> is a usable previewer for models in any format Mineways produces, though handles transparency and cutouts incorrectly.
  <P>
  Below are steps for using various popular rendering software packages. There are always more; for example, <a href="https://blog.yiningkarlli.com/2016/07/minecraft-in-renderman-ris.html">this article</a> talks in depth about using RenderMan for rendering.
</div>

<HR>
<H4 id="blender">Blender</H4><p>
<a href="https://www.blender.org"><img id="productLogo" src="images/blender_icon.jpg" alt="Blender icon"></a>
<P>
These instructions assume Blender version 3.5 or newer. I've made <a href="https://youtu.be/uVogzXQ6UKs">a 13-minute video of different ways to import into Blender 3.5</a> and perform rendering, which covers most of the first nine steps below.
<P>
Alternative Minecraft exporters for Blender include <a href="http://www.jmc2obj.net/">jmc2obj</a>, a general-purpose and full-featured exporter, and <a href="http://randomsamples.info/project/mineblend/">Mineblend</a>, which is dated, but is tailored specifically for Minecraft to Blender import. There are tons of other Blender+Minecraft things out there. For example, <a href="https://www.replaymod.com/">the Replay Mod</a> lets you create an animation path in Minecraft and export the camera moves. You can then import the .GLB animation file into Blender.
<P>
To move your Minecraft world's data into Blender, the first step is always the same, since it involves only Mineways:
<P>
<b>1) Open your World in Mineways</b>, then, select the area for exporting (hold right mouse button and drag the rectangle).
<P>
You can now go two routes: OBJ or USD file export. If you are using the standard or other low-resolution textures, without any normal maps (which the Blender importer does not seem to recognize), OBJ is perhaps enough. If you do use normal maps or want to avoid using MCprep, USD import may serve you better. It doesn't hurt to try both.
<P>
<b>2a) OBJ export: Choose "File | Export Model for Rendering"</b> and save the file as a Wavefront Object (.obj) to a folder of your choice. Let's call it myobject.obj or whatever you like. You can simply click "OK" in the dialog with the export settings.
<P>
If you like, <a href="https://www.youtube.com/watch?v=gHYTQBnKGjc">watch this one-minute video</a> for OBJ export and import. Things have changed a bit since that video was made. You don't need to select <a href="#material_subtypes">"Split by block type"</a> at 0:44, as this is now the default. 
<P>
If you are <a href="#individual">exporting individual blocks</a> for animation, check the "Material per family" box. If you want to be able to select block types in the viewport for hand-editing, check the option <a href="#make_groups_objects">"Make group objects"</a>. If you don't choose this groups objects option now, that's fine - step #11 below shows you how to do this in Blender.
<P>
<b>2b) USD export: Choose "File | Export Model for Rendering"</b>, for "Save as type" at the bottom choose "Universal Scene Description (*.usda)", and save to a folder of your choice. You can simply click "OK" in the dialog with the export settings.
<P>
<b>3) Open Blender 3.5</b> (or newer) and click anywhere on the screen to make the splash screen disappear. Then press the "Delete" key to remove the default cube model. If you're importing a USD file, you will also want to select the default Light in list in the upper right and delete it, too.
<P>
<b>4) Import the model:</b> select "File | Import | Wavefront (.obj)" or "File | Import | Universal Scene Description (.usd*)" from the menu (Note there are two OBJ importers - pick the one closer to the top, not the one at the bottom that says "legacy" after it). Put the directory name of your Mineways export file (the .obj or .usda file) on the first line and hit "Enter". You can then double-click the .obj/.usda file name itself in the listing below. Alternately, you can type the file name itself on the line below the directory name and then click the blue "Import OBJ/USD" button to the lower right.
<P>
On the right side of the import dialog you will see import options. I never touch these, but they're worth knowing about, e.g., you might want to scale the model size down on import.
<P>
Once imported, you can hit the "Home" key to reposition the camera to be well outside the model.
<P>
<b>5) Display in Look Dev mode:</b> in the upper right of the viewport are a series of icons. Rightmost are four sphere icons. Click on the rightmost:
<p class="left">
<img src="images/b28_render_icons.jpg">
<p>
You should now see a textured view of your model.
<P>
<b>6) Adjust camera:</b> Use the mouse wheel to dolly the camera in or out. As noted before, the "Home" key can also dolly the camera out to view the whole scene. Middle mouse down and drag lets you rotate the camera. Middle mouse drag with the Shift key lets you pan the camera. Middle mouse with Control is another way to dolly, but why do that? Middle mouse drag with Alt changes to different orthogonal views in a funky way - just use middle mouse drag to recover.
<P>
For USD, a camera comes with the file. Nothing great, but it can be used, and sometimes will work when the model disappears due to Blender weirdness. You can pick it in the upper right, "Camera.001", then in the second row of menus in the upper left pick View -> Cameras -> Set Active Object as Camera.
<P>
Another way to move around the scene is to turn on Walk or Fly navigation. Hit F3 and type "walk" and pick the "View -> Navigation -> Walk" line. Now the WASD keys will work like they do in games, Q and E go down and up, spacebar will take you to where you're pointing, Shift will increase the speed of any letter key. Fly is similar, but you're setting the velocity. If you click somewhere you leave this mode. Just press F3 and Enter to return to it.
<P>
<b>7) Lighting:</b> For OBJ, change the default light to be more useful. Click on the Sun setting, then I'd also crank the Strength down to 8.0 or so, as shown:
<p class="center">
<img src="images/b28_sunlight.jpg">
</p>
For USD, the file comes with a sun light (and a dome light, which Blender currently ignores). This light <i>may</i> import with a strength of 50000. Or 2.284. As with the OBJ instructions above, change the strength to around 8.0 or whatever you like.
<P>
To adjust the direction of any light, select it, press Shift-T, and move your mouse around in the viewport. Hey, the sun's moving. When you left click with the mouse, you lock down the direction of the sun. It's a bit non-intuitive, and you may need to rotate the view, Shift-T, rotate again, etc. to get the angle you want. Try F12 again to render the scene.
<P>
Frankly, an easier way to control the light's direction is to choose the orange box icon ("Object Properties") a few up from the lightbulb icon in the vertical strip of icons. Then play with the Rotation angles: if you set these to 0,0,0 for XYZ you'll have a light directly overhead. Go from there (and there's probably some good "Mode" to set the light to, but I haven't figured one out yet...).
<P>
<b>8) Rendering:</b> You are now ready to do a first render of your model. Once you like the view, click Control-Alt-"Numpad 0" (the zero in the lower right of your keyboard) to set the render camera to your view (or at least the center of it). If you move your view of the world, you can go back to this saved view by hitting "Numpad 0" again, or Control-Alt-"Numpad 0" to set the render camera again.
<P>
However, there's a better way. In the upper right corner of the viewport there's an "Options v" menu. Just below that there's a little "&lt;" symbol. Click that and you'll see more menus appear: Item, Tool, View (and MCprep, if you add this). Alternately, click the "N" key, which toggles the display of these. Now click on View, open up the dialog that appears, and click the box that says "Camera to View" under View Lock. This makes it so that what you see in the rectangle is what you get. You might want to first use the mouse wheel to adjust this rendered view's rectangle, then turn this on.
<P>
But wait, there's more. If you find some or none of your model appears when you dolly out, you need to adjust the clip range. In this same View dialog change the "End" value from 1000 m to something larger, e.g.:
<p class="center">
<img src="images/b36_view_end.jpg">
<P>
If you do change this, I've found it's good to then change Clip Start to 1 m or higher, else you'll get strange z-fighting artifacts around the edges of blocks.
<P>
Now press "F12" or select "Render | Render Image" from the menu and have a look.
<P>
The distant part of the model might not appear, as the Clip End distance of the camera might still be too small, which somehow (if you didn't click "Camera to View" is a separate clip range. Adjust this distance by selecting the camera object in the Scene Collection in the upper right of the screen, select the camera icon, then click on the "End" value box and type in a new value such as 1000 m or simply drag your mouse:
<p class="center">
<img src="images/b28_camera.jpg">
<P>
Another alternative is, when exporting from Mineways, make the model smaller. In the upper right of Mineways' export dialog you'll see "Make each block 1000 mm high." If you change "1000" to "10" or similar, the exported blocks will be smaller. You can also change the scale on import to Blender, which is even simpler. Making the model smaller will also often make shadows work again with the Eevee renderer; these disappear if the model is large, for some reason.
<P>
To get back to rendering, the render will look pretty much like what you already see on the screen. To use a higher-quality, but slower, renderer, do this: Along the top of the program click on the gray "Rendering" (<i>not</i> white "Render") menu item, towards the middle. In the upper right, under "Scene," you'll see "Render Engine". Pick "Cycles" instead of "Eevee." Now on the top edge click on "Layout", which is what was selected originally. Things will look nicer, but interaction will be laggy. If you want faster interaction, in the upper right corner of the viewport select the second-from-the-right sphere icon, the material preview mode. What F12 does is uses the renderer you select. If you chose Cycles, it will progressively improve the result, by default running 4096 passes to give a nice final image. You can see the Sample counter along the upper edge of the image for progress. Save your image using the Image menu along the top. Close this window when you're done.
<P>
<a id="blender_blocky"><B>9) Material Conversion:</B></a> This step will improve OBJ files, and can make USD textures look "chunky". Low resolution textures are fuzzy, not blocky like in Minecraft. Transparent objects such as water and glass may not look quite right. Cutout objects have poor blending modes assigned, and anything with transparency will not cast shadows properly. The fastest way (by far) to fix these problems in OBJ files is to use the Prep Materials button in <a href="https://theduckcow.com/dev/blender/mcprep/">the free MCprep addon</a>. <a href="https://youtu.be/XndRsS6KWkw">Here's my short video</a> on how to install and use it. They also have a <a href="https://discord.gg/mb8hBUC">MCprep Blender Discord server</a> with people that are quick to respond to Minecraft + Blender questions.
<P>
As I say, USD imports can be made to look chunky. Unfortunately, the MCprep add-on also seems to remove normal maps. So, read on.
<P>
Another automated method that fixes just the blockiness for OBJ or USD is to use a script. The advantage of this method over MCprep is that you are in control, making minimal changes to the materials. First paste this text into a text file (or use the one Mineways provides in <a href="https://github.com/erich666/Mineways/blob/master/scripting/blender_blocky.txt">scripting/blender_blocky.txt</a>):
<P>
<PRE>
import bpy

for mat in bpy.data.materials:
    if not mat.node_tree:
        continue
    for node in mat.node_tree.nodes:
        if node.type == 'TEX_IMAGE':
            node.interpolation = 'Closest'
</PRE>
Then, in Blender, just below the bottom left of the viewport click on the little clock icon ("Editor Type") - it looks a bit like a "&lt;" - and select "Text Editor" under the Scripting header, third over. You will now see a little text icon replacing the clock. Use Text | Open to open your saved text file, then do Text | Run Script (or hit Alt-P) to run the script:
<p class="center">
<img src="images/b29_closest_script.jpg">
</p>
Doing so will change all materials to look blocky.
<P>
If instead you want to do this conversion manually, it's a tedious process of selecting each object type in the model (and, in fact, trying it out manually on Blender 3.1.0, I could not get this process to work properly - not sure why). You still might want to do this once, just to understand the material properties better. Select a material and, under the Surface parameter window below, click the small "right arrow" icon to the left of "Base Color", about five lines down. Two more lines down it will say "Linear"; change this to "Closest". Scroll down considerably further to "Alpha" and click on the small right arrow again and also set to "Closest". Here's the Base Color sequence:
<p class="center">
<img src="images/b28_blocky.jpg">
</p>
<P>
All this said, setting the sampling to "Closest" can give noisy renders, as far away objects may twinkle or form Moir&eacute; patterns. You may want to consider using <a href="blurry">the high-resolution "1024" or "8192" textures</a> when exporting from Mineways, as these give a blocky appearance and also allow mipmapping to be used for filtering when blocks are distant.
<P>
With OBJ you might also notice that objects underwater kind of pop out, like they're not in water. To fix this, in the properties page below, in Settings at the very bottom, change the water's Blend Mode and Shadow Mode both to Alpha Hashed. Here's an example of doing this for glass, which can have the same problem:
<p class="center">
<img src="images/b28_transparency.jpg">
</p>
Here is the automated script for this, called <a href="https://github.com/erich666/Mineways/blob/master/scripting/blender_alpha_hashed.txt">scripting/blender_alpha_hashed.txt</a>:
<P>
<PRE>
import bpy

for mat in bpy.data.materials:
    """If material has nodetree"""
    if mat.node_tree:
        for node in mat.node_tree.nodes:
            if node.type == 'BSDF_PRINCIPLED':
                alphasocket = node.inputs["Alpha"]
                if alphasocket.is_linked:
                    mat.blend_method = 'HASHED'
                    mat.shadow_method = 'HASHED'
</PRE>
These two scripts above could be combined into one text file: just paste one after the other (removing the "import bpy" line, which is needed only once).
<P>
There are plenty of other material properties you can modify, these are just a start. You can read documentation on the Blender site about <a href="https://docs.blender.org/api/current/bpy.types.ShaderNodeTexImage.html">texture</a> and <a href="https://docs.blender.org/api/current/bpy.types.Material.html">material</a> modification. Have fun!

<P>
<b>10) Render Size:</b> You can also set several parameters of the Renderer by selecting the Camera in the Scene Collection in the upper right, then clicking on the Context.Output icon in the vertical list of icons - it's the third one down, it looks like a printer spitting out an image. In the section "Dimensions", you can set the Resolution of the image, add a border, and so on. To export Full HD, you can set the Resolution to X:1920 and Y:1080, and set 100% in the bar below these settings.
<P>
<b>11) Optional: Split into Objects:</b> Blender 2.92 imports a Mineways OBJ file as a single object. If you did not use the <a href="#make_groups_objects">"Make groups objects" option</a> but now want to split the object in Blender, do the following. First, <a href="https://www.katsbits.com/codex/edit-mode-basics/#edit-mode">switch to Edit Mode</a>. Then hit the "p" key and with your mouse select the option "By Material." The objects will now be separated in this way. Separate objects is nice for selection and material editing, but by default "separate" objects are not so separate - if you move one, you'll see a gap where it touched other blocks. If you truly want separate blocks, for animation or other reasons, you'll need to use the <a href="#individual">"Export individual blocks" option</a> in Mineways to get "solid" blocks you can animate.
<P>
<b>12) Upload</b> pictures of your creation to <a href="https://discord.gg/wfayQA6Dyc">the Mineways Discord</a> #showcase channel or <a href="https://www.reddit.com/r/mineways/">the reddit group</a>. (Optional, but I hope you do - I like seeing what people make.) You can also look in the <a href="https://www.realtimerendering.com/erich/minecraft/public/mineways/community.html">website gallery</a> or old <a href="http://www.flickr.com/groups/mineways/pool/">Mineways Flickr group</a> for some past screenshots.
<P>
I'll again note that you should probably be using <a href="https://theduckcow.com/dev/blender/mcprep/">MCprep</a> to convert your OBJ materials. <a href="https://youtu.be/XndRsS6KWkw">Here's my short video</a> on how to install and use it. They also have a <a href="https://discord.gg/mb8hBUC">MCprep Blender Discord server</a> for asking questions.

<HR>
<H4 id="ovcreate">Omniverse USD Composer</H4><p>
<a href="https://www.nvidia.com/en-us/omniverse/apps/create/"><img id="productLogo" src="images/ov_create_icon.jpg" alt="Omniverse USD Composer icon"></a>
<P>
Here is how to import a model into the free Omniverse USD Composer program. First, download the <a href="https://www.nvidia.com/en-us/omniverse/apps/create/">Omniverse Launcher</a>, install and run it, then from the launcher install and launch Omniverse USD Composer.
<P>
See <a href="https://youtu.be/tBDGH5v40x8">the tutorial video</a>. It runs through a lot of the common operations for Omniverse USD Composer: moving the camera, modifying the lighting and materials, etc. There's a lot of documentation on <a href="https://docs.omniverse.nvidia.com/">Omniverse</a> and <a href="https://docs.omniverse.nvidia.com/app_create/app_create/overview.html">Create</a>, but the video will get you started. I also give some tips and tricks in <a href="https://youtu.be/lpFpj84eFgw">this "the whole process" video</a>. I also show Omniverse in action <a href="https://youtu.be/EH8NhyusZBU">here</a>. What follows are the steps in the first video.
<P>
<b>Step 1:</b> Select your world and region for export in Mineways, then from the menu choose File | Export Rendering.
</P>
<P>
<b>Step 1a:</b> I highly recommend doing "File -> Choose Terrain File" and selecting the terrainExt_JG-RTX64.png file that comes with Mineways. This will give you more interesting and physically realistic materials for some blocks.
</P>
<P>
<b>Step 2:</b> Save as the file type 'USDA'. This is the <a href="https://graphics.pixar.com/usd/docs/USD-Frequently-Asked-Questions.html">Universal Scene Description ASCII file format</a>. USD is a format developed by Pixar that is used in film studios and other applications. You can see my <a href="https://github.com/erich666/McUsd">test scene project</a> for an idea of how various renderers handle this file format as of August 2022 (they're always improving).
<P>
After choosing the file name, you are faced with many export options. Most are grayed out in the upper left part of this dialog, with one important exception: "Custom material." By default this box is checked. Doing so gives the distinctive blocky look for Minecraft textures. However, if you are using higher resolution textures, 64x64 or larger, I recommend unchecking this box. You will then use Omniverse default materials, which blend smoothly between texture texels. Also, these default materials will display much more quickly; the custom materials need to be compiled when viewed in Omniverse USD Composer for the first time.
<P>
Setting the "Light scale" to 0 will turn off export of lights and camera. The "Export individual blocks" option works, though has not undergone much testing.
<P>
As far as other export options go, best of luck. USDA export is a new feature, so some modes to be unlikely to work fully. I am happy to listen to requests for improvements in any of these areas.
<P>
Note that Pixar USD files can be read in by other applications, for example the free <a href="#houdini">Houdini Apprentice</a> and <a href="mineways.html#c4d">Cinema 4D</a>.
</P>
<P>
<b>Step 3:</b> Load the model into Omniverse USD Composer. Easiest is to copy and paste the directory where the USDA model is located into the Content directory bar, towards the lower left, here highlighted in red:
<p class="center">
<img src="images/ov_content_bar.jpg">
</p>
Hit "Enter" and below this line you should see the USDA file, some MDL (material) files, and a texture directory. Double-click the USDA file to load it. The scene may take a while to resolve and look good, as two things are happening: textures are loading, and material shaders are being compiled (if "Custom material" was checked - see Step 2). This compilation can take a while, but after the first time you do it for a directory it should be faster.
<P>
Pro tip: if you click on the bookmark icon, highlighted in green (and already clicked) in the image above, you will add a bookmark to the list of files at the lower left. Clicking that bookmark entry takes you to this directory.
<P>
Note: one glitch in the beta is that the directory shown in Create does not refresh when new files are added to it, or deleted. If you save and don't see your file, right-click in the window to the lower right and select "Refresh" (highlighted in orange).
<b>Step 3a:</b> Adjust the orientation of the dome (environment) light. As of August 2023 there is a bug in USD Composer (and possibly other packages) in which the Dome light comes in sideways. The fix is to select the "DomeLight" in the hierarchy list in the upper right. Then in the Transform section in the lower right, change the Rotate X value from 0 to 270.
<P>
<b>Step 4:</b> Move your camera around. Easiest is to right-click-and-hold in the viewport. Mouse rotates the view, WASD moves you, QE move up and down, and holding Shift during any of these key presses doubles your speed (and Control halves it). If you get lost, the F key will frame your model, i.e., pull you all the way back so you can see the whole thing. One gotcha is camera speed: you can adjust this by clicking on the gear icon in the upper left of the viewport and adjusting the first slider, Camera Speed. To go faster than 10, you can Control-Click on the slider and type a number.
</P>
<P>
<b>Step 5:</b> Adjust the lighting. Look in the upper right. Select the Stage tab, if not selected. You'll see the sun and a dome light. You can toggle these on and off by clicking the eye icon to the right of each. You can move the position of the sun by selecting it, then clicking and dragging in the box highlighted to rotate its angle. You can also adjust the sun and dome light's intensity in the Light dialog area below. Also, note that if you toggle the "lighting" view in Mineways (the "L" key), so that the map is shown in a nighttime mode, nighttime lighting will be exported to USDA instead.
<p class="center">
<img src="images/ov_sun.jpg">
</p>
<P>
<b>Step 6:</b> Take a screenshot. First, you'll need to adjust one property. On the menu choose Edit | Preferences. At the bottom left see the Preferences dialog. Click on Capture Screenshot, and then on the right check "Capture only the 3D viewport":
<p class="center">
<img src="images/ov_preferences.jpg">
</p>
Take note of the "Path to save screenshots", just above - I copy and paste this and go to it in my file explorer. Now, each time you press F10, a screenshot is generated and put in this directory.
<p class="center">
<img src="images/ov_post.jpg">
</p>
I have noticed this feature can sometimes be a bit flakey, with F10 not consistently working after adjusting this. Restarting Create seems to help.
<P>
<b>Step 7:</b> Adjust the camera exposure. By default, the camera exposure is set for a daylit, outdoor scene. If you go inside, it'll likely be dark. In the menu, choose Rendering | Render Settings, if not already checked. In the upper right should appear "RTX Settings". By default, Mineways uses the Path tracer, so select "Path-Traced" for the Renderer, then "Post Processing", below that to the right. Open the Tone Mapping menu. You can then fiddle with the Film ISO, Camera Shutter, and f-Number/f-Stop to adjust the exposure. If you're feeling bold, you can also try the Auto Exposure feature in the menu below Tone Mapping.
<P>
<b>Step 8:</b> Edit a material. Click on an object in the scene, or in the content hierarchy in the Stage list in the upper right (pro tip: you can type. Below a picture of a sphere should appear. Click the sphere and you will see below a long list of material settings. Have at it! Note that you can also simply replace textures in the "textures" directory created by Mineways and then read the scene in again.
<P>
Bonus feature: I've included a water_normal.png normals map (from the open source <a href="https://www.nvidia.com/en-us/design-visualization/technologies/material-definition-language/">MDL material set</a>) in the Mineways distribution. Resource pack authors basically never include a normal map for water, because the renderer usually generates this. You can include this in your "block-and-chest" directory when <a href="textures.html">making a terrain file set</a> using TileMaker or assign it manually in Create or other applications.
<p class="center">
<img src="images/ov_material.jpg">
</p>
<P>
<b>Step 9:</b> Save your work. You can simple choose "File | Save", but for faster loading in the future, you could do "File | Save As...", check that "USD" (no "A") is selected in the lower right of the save dialog, and click "Save". The binary USD format is about 30% more compact and faster to load.
<P>
For more about physical materials and how to add them into Mineways, see the <a href="textures.html">texture tutorial page</a>.
<P>
By default the RTX Path-Traced renderer is used, as shown in the upper left corner of the Omniverse USD Composer viewport. Changing this to "RTX Real-Time" will give faster, lower quality renders. If you want even faster interactivity - useful for large scenes - click on the Render Settings tab in the upper right, select "Real-Time" for the Renderer if not already selected, choose the "Ray Tracing" option just below, then under Translucency uncheck the box "Enable Fractional Cutout Opacity." Having this box checked can be up to 3x slower than unchecked.
<P>
This is as far as I'm going, as explaining <a href="https://docs.omniverse.nvidia.com/app_create/app_create/materials.html">materials</a>, <a href="https://docs.omniverse.nvidia.com/app_create/prod_extensions/ext_animation.html">animation</a>, and <a href="https://docs.omniverse.nvidia.com/app_create/app_create/overview.html">many other features</a> is definitely beyond the scope. But, notice that last sentence has links to documentation for these topics. Some people <a href="https://www.youtube.com/embed/fCLE_9SNL8M">know <i>way</i> more</a> than I do about Omniverse.
<P>
Since you got this far, I'll note one option you <i>can</i> choose at Mineways export: the "Custom material" checkbox on the export dialog. By default it is checked. This exports a custom Minecraft.mdl material that gives textures the classic blocky look. However, if you are using a high resolution texture you likely won't care about this look. Unchecking the box means to use the default materials, no MDL files written out. A minor thing, but you may prefer it.

<P>
Here's <a href="https://github.com/jasonjgardner/jg-rtx">JG RTX</a> in action (and <a href="https://photos.app.goo.gl/sUbwZjZ6JxgPGU4HA">more resource pack previews</a> - these are not included in Mineways):
<P>
<a id="jgrtx"><img src="images/jgrtx_pbr.jpg" alt="JG RTX"></a>


<HR>
<H4 id="c4d">Cinema 4D</H4><p>
<a href="https://www.maxon.net/en-us/products/cinema-4d/overview/"><img id="productLogo" src="images/cinema4d_icon.jpg" alt="Cinema 4D icon"></a>
<P>
These instructions explain how to import a model and set the textures are mostly for Cinema 4D R25 or newer; the instructions are similar for older versions, though USD support is unlikely. Really, I should redo this section, but I hope you'll be able to figure things out. Most steps are mostly from <a href="http://www.youtube.com/watch?v=xx4WNvV6k4E&list=PL3AE7AB94E9114715&index=7&feature=plpp_video">this excellent (though now-dated) video</a> from <a href="https://www.minecraftforum.net/forums/show-your-creation/videos/1637913-making-amazing-minecraft-scenes-in-cinema-4d">this forum post</a>, which includes a number of other useful Cinema 4D animation tutorials and resource links. Here's <a href="https://www.minecraftforum.net/forums/show-your-creation/videos/1624794-minecraft-3d-essentials-cinema-4d">one more useful post</a>.
<P>
That said, you may instead want to use <a href="http://www.jmc2obj.net/">jmc2obj</a>, another exporter. I won't be insulted - use what works best for you!
<P>
<b>Step 1:</b> In Mineways, select your world and region for export in Mineways, then from the menu choose File | Export Rendering.
</P>
<P>
<b>Step 2:</b> You have two choices here, USD (Pixar's Universal Scene Description) or OBJ export. USD is particularly useful for physically based rendering resource packs, such as JG-RTX that comes with Mineways. Beyond color and transparency, these packs include normal maps, specular textures, and more. Alternately, save as the file type 'OBJ'. Use Absolute OBJ, not Relative, as older versions of Cinema 4D do not read relative OBJs well.
</P>
<P>
<b>Step 3:</b> For USD export, make sure to set "Light scale" to 1, else the sun will be too bright (you can always fix this in C4D itself by turning the sun from 3000% to 100%). Otherwise, adjust the export options as you wish. By default, blocks will come in at a size of 1/10th meter each. You can adjust this by changing "Make each block 100 mm high"; for example, 1000 mm is 1 meter. You may also wish to use the <a href="#fcst">"Export individual textures"</a> option, as this allows mipmapping and similar filtering in Cinema 4D to work better.
</P>
<P>
<b>Step 4:</b> Once the model is exported, open Cinema4D and drag the .usda or .obj file generated into the main window. <B>For OBJ, make sure the "Presets" at the top of the OBJ Import dialog is set to Default.</b> (If you don't, your grass blocks will import upside-down.) Hit "OK".
</P>
<P>
Here is what the OBJ defaults are, just in case:
</P>
<P>
<img src="images/c4d_export.jpg" alt="Cinema 4D object load"></a>
</P>
<P>
To move around the scene, hold down Alt and use the three mouse buttons and scroll wheel. For USD you may wish to rotate and turn down the brightness of the DomeLight. First, choose it in the upper-right Objects dialog's list (opening the world's list first). Pick "Coordinates" and then change "R.P" to -90. Then, pick "Tag" below and then under "Color" set "Brightness" to 50% or as desired.

<P>
<b>Step 5:</b> At this point you can render by clicking Ctrl-R. It won't be the most exciting render, as there are no lights. Try "Create -> Light -> Light" and move the light up a bit to illuminate your scene. Select the light and in the material editor in the lower right, select "Shadow" and then, a few lines down, change "Shadow" from "None" to "Raytraced (Hard)." Now Ctrl-R will give shadows to your scene.
<P>
<b>Step 6:</b> Select all the materials in the material manager, the row of spheres at the lower left (or alongside the right edge of the viewport). Do this by clicking one sphere and then hitting Control-A. All spheres should now be selected. If the material manager is not visible, open it with Window -> Material Manager, or the shortcut Shift+F2.
</P>
<P>
<b>Step 7:</b> If you want to make textures look blocky, like they do in Minecraft, do the following. In R25 or newer, you select the material, then pick "Tag", then "Material", then "Color" in that area. For older versions, first click on the "Color" box next to the "Basic" box at the top of the material editor, then in this area you will see a section below labeled "Color." In this section you will see "Color," "Brightness," "Texture." Just below "Texture" and to the right, "Sampling," which will say "MIP" or "&lt;&lt;Multi." In the menu list for this option choose "None." When you are done selecting, it may still say "&lt;&lt;Multi", but don't worry, you have changed it. See the figure below for how things looked in R22.
</P>
<P>
<img src="images/c4d_texture.jpg" alt="Cinema 4D color material"></a>
</P>
<P>
That said, setting the sampling to "None" can give noisy renders. You may want to consider using <a href="blurry">the high-resolution "1024" or "8192" textures</a> when exporting from Mineways, as these give a blocky appearance and also allow mipmapping to be used for filtering when blocks are distant.
<P>
That's about it! I'll mention that you can also import Mineways' VRML files into C4D. This will work, but all blocks will share the same material, limiting what you can do to them.

<HR>
<H4 id="houdini">Houdini</H4><p>
<a href="https://www.sidefx.com/buy/#houdini0"><img id="productLogo" src="images/houdini_icon.jpg" alt="Houdini icon"></a>
<P>
Houdini Apprentice can be <a href="https://www.sidefx.com/buy/#houdini0">downloaded for free</a> for non-commercial use. Houdini Apprentice pays attention to the UsdPreview material Mineways produces. Their support for USDA continues to improve, so get the newest version when you can. One nice thing about Houdini is that it can read USDA files from Mineways, allowing more elaborate material descriptions, such as using normal maps. Make sure to have the newest version (at least version 19), as their USD import has improved enormously recently.
<P>
I made <a href="https://www.youtube.com/watch?v=w3qCPts_70I&t=67s">a short tutorial video</a> for how to import Mineways USDA models with physically-based rendering textures attached to them. It's for an older version of Houdini, but should get you most of the way there.

Here's a run through for Houdini 19.5.303: select Build -> Solaris, right-click in the lower right "/stage" dialog, type "file," and pick "Sublayer" in the USD dialog that pops up. Then click in the dialog to place this element. Above this dialog, in the upper-right of the application, is now "Sublayer file1" - scroll down to find "Sublayer File" and in "File" give the USDA file you want to import. Once imported, scroll out with Alt and mouse-wheel down. Turn off the sun and dome light in the lower left dialog, "Scene Graph Tree." Add your own lights from the icons in the upper left of the app. Hold down "Alt" and use the mouse for camera moves. In the upper right of the viewport select the Karma renderer from "persp" to use the path tracer. 
<P>
One thing I did forget to mention in the video narration: at time 1:14, where I add a File node, what I did was right-click in that lower-right area and typed "file" to get that node, then clicked in the area to make the node appear.

<HR>
<H4 id="3dsmax">3DS MAX</H4><p>
<a href="https://www.autodesk.com/products/3ds-max/overview"><img id="productLogo" src="images/3dsmax_icon.jpg" alt="3DS MAX icon"></a>
<P>
Note: <a href="https://www.autodesk.com/education/free-software/3ds-max">3DS MAX is free for students and teachers</a>.
<P>
These instructions are for 3DS MAX 2012. You might also try <a href="http://www.jmc2obj.net/">jmc2obj</a> instead, as it does a better job producing some geometry. The steps here should also work for cleaning up jmc2obj OBJ models.
</P>
<P>
For newbies (like me): in a Viewport, middle-mouse button changes the view: mouse-wheel to zoom, button to pan, Alt key down to rotate, Control key down to fast-pan. Shift+Q to render. Steps are as follows:
</P>
<P>
<b>Step 1:</b> Select your world and region for export in Mineways, then from the menu choose File | Export Rendering.
</P>
<P>
<b>Step 2:</b> Save as the file type 'OBJ'. You likely want to keep the <a href="#full_material">"Custom material" option</a> on, as this gives a slightly different water color by changing the diffuse color to white.
</P>
<P>
<b>Step 3:</b> Adjust the export options as you wish. Nothing is required here; by default, blocks will come in at a size of 1/10th meter each. You can adjust this by changing "Make each block 100 mm high"; for example, 1000 mm is 1 meter, MAX's unit size.
</P>
<P>
<b>Step 4:</b> Use the upper left MAX symbol menu and select Import. Find the .obj file and select it. In the OBJ Import Options, under Normals select Faceted to get Minecraft's blocky look. Alternately, if you want to smooth water surfaces a bit, select "Auto" and leave the setting at 30 degrees. Click "Import" at the bottom.
<P>
<b>Step 5:</b> Go to Render Setup in the Rendering menu (or just hit "F10"). Select the Renderer tab and uncheck the "Filter Maps" checkbox under Antialiasing. This makes cutout objects look correct, as well as making the Minecraft textures have their distinctive blocky appearance.
</P>
<P>
<b>Step 6 (optional):</b> At this point rendering should work fine. In interactive preview mode you will see some transparency problems in the Viewport. To fix these, bring up the material editor by pressing "M" and expand the view. Scroll down in the Material/Map Browser on the left and find "+ Scene Materials". Click on the "+" to show the scene's materials. Double-click on whatever material looks bad, e.g., Stationary_Water, Glass, Leaves, Torch, Tall_Grass, Sugar_Cane, Rose, Dandelion, or other cutout object. Now click on the "checkerboard-with-light" icon along the top, which does "Show Shaded Material in Viewport". This material should now look better. Do this for each material that looks bad. Press "M" again when finished, to dismiss the material browser. If someone knows a faster way to change all materials, let me know. Note that these fixes do not affect the final render itself.
</P>

<HR>
<H4 id="maya">Maya</H4><p>
<a href="https://www.autodesk.com/products/maya/overview"><img id="productLogo" src="images/maya_icon.jpg" alt="Maya icon"></a>
<P>
Note: <a href="https://www.autodesk.com/education/free-software/maya">Maya is free for students and teachers</a>.
<P>
First, there is now a <a href="https://github.com/Blocker226/MinewaysToRenderman/releases">material converter for RenderMan</a>. Notes from the author: "I've created a simple Python script for Maya to convert all the imported materials from the standard 'Phong' shader to Renderman's 'PxrSurface' shaders. It'll also re-use the same file reference node and clean up the duplicates and the old shaders. Bonus is that it will also turn off filtering on all the textures."
<P>
If you want to rendering within Maya, I will not give a comprehensive tutorial here; it's up to you to know the basics. The main tasks facing you when importing from Mineways is adjusting the Transparency material attribute, which Maya does not set up at all on import. The steps:
<OL>
<LI>Import an OBJ from Mineways. Turn on texturing and lighting by pressing "7".
<LI>Select each transparent or cutout object in turn, right-click and drag to choose the "Material Attributes" menu.
<LI>On the right, under Common Material Attributes, click the small checkered box to the far right of the Transparency attribute. This will let you assign a texture to the alpha channel.
<LI>In the "Create Render Node" dialog that appears, choose "Maya | 2D Textures" on the left, then click "File" on the right. You will now see a "File Attributes" parameter dialog.
<LI>Click on the file folder icon to the far right of "Image Name" and select the grayscale image for the alpha channel, e.g., MyModel-Alpha.png. While you're here, you can change the "Filter Type" above from Quadratic to Off; this makes the alpha channel have the blocky Minecraft look.
<LI>The cutout object will typically disappear; you need to reverse the sense of the channel. There's probably some easier way, but scrolling down to the "Color Balance" section and setting Alpha Gain to -1 and Alpha Offset to 1 works.
<LI>To make the colored pixels blocky, again right-click on the model and select "Material Attributes...", then click the small box with an arrow to the far right of the "Color" attribute, the first thing listed under "Common Material Attributes." Change the "Filter Type" from Quadratic to Off.
</OL>
There may (and probably is) a more efficient way to make these adjustments - let me know.
<P>
For instructions for older versions of Maya, check out <a href="http://www.youtube.com/watch?v=MWdtaeRcNUs">this video</a> from <a href="http://www.youtube.com/playlist?list=PL19DDBAB5C26254AD">this playlist</a>, it shows how to set transparency and texture sampling. That said, you may want to use <a href="http://www.jmc2obj.net/">jmc2obj</a>, which even comes with a MEL script to perform cleanup during import (that said, I don't know if this script still works).
<P>
A problem with jmc2obj is that each material must be adjusted by hand. One option in Mineways that can speed import conversion is to uncheck the "Material per family" checkbox in the OBJ file export options. Doing so means you have to fix up only one material, though at the expense of not having a separate material per block family (that said, you can always add new materials later). That said, this option tends to mess up Maya's display, as every object will be considered semitransparent and all will be sorted from back to front by depth in the interactive viewport, causing objects to flicker in front of each other. The scene will render just fine, however.
</P>

<HR>
<H2 id="sketchfab">Publish to Sketchfab</H2>
<p>
<a href="https://sketchfab.com"><img id="productLogo" src="images/sketchfab_icon.jpg" alt="Sketchfab icon"></a>
<P>
<a href="http://sketchfab.com">Sketchfab</a> is a free service that lets you upload your models and share them with others; try an example <a href="https://skfb.ly/IQyA">here</a> or look at the end of these instructions. Mineways exports to it in a straightforward fashion, there are just a few steps to get your model up and running. It's always been possible to upload models to Sketchfab, see these <a href="https://help.sketchfab.com/hc/en-us/articles/206738956-Minecraft-Mineways">illustrated instructions</a>. With the 4.16 version of Mineways you can now publish directly from Mineways to Sketchfab. Note: you can always export a rendering as usual to an OBJ file and upload the ZIP of the files output to Sketchfab. This will give a somewhat different rendering style, sharp and less shadowed.
<P>
<b>1) Sign up for an <a href="https://sketchfab.com/">account on Sketchfab</a></b>.
</P>
<P>
<b>2) Open your World in Mineways</b>, then, select the area for exporting (hold right mouse button and drag the rectangle), and choose "File | Publish to Sketchfab" from the menu.
</P>
<P>
<b>3) The Sketchfab dialog will come up.</b> Click on the button "Get your token." This will open a web page.
<div>
  <img src="images/sketchfab_dialog.jpg">
</div>
<P>
One line says "API Token," as shown below. Copy the API token, a long string of letters and numbers (a black box covers mine here), and paste it into the Sketchfab dialog. Fill in the other fields as you wish, then click "Upload" at the bottom.
<div>
  <img src="images/sketchfab_token.jpg">
</div>

<P>
<b>4) When done, a new dialog comes up saying, "Your model has been uploaded. Click OK to view it on Sketchfab."</b> - do that!
</P>
<P>
<b>5) On the model's web page, adjust and save the view.</b> You can orbit, pan, and zoom (mouse wheel). In the lower right corner is an eye icon, where you can switch to a "First Person" mode - I find it a bit zippy by default, so use the mouse wheel to dial down the speed. Also, if you double-click with the middle-mouse button on your object, you set the pivot point that the camera orbits around. Pick a nice view and then click "SAVE VIEW" in the upper left-hand corner. 
</P>
<P>
<b>6) In the lower right of the window click "SETTINGS" and choose "3D settings".</b> I recommend clicking on the light-bulb icon in the upper left, then turn on the lights (just below); this will give shadows. There are lots of options here - explore and have fun! You can change the surrounding environment, make various materials look different, and other options. Annotations are nice for setting up views and touring your model.
</P>
<P>
<b>7) In the upper right click "SAVE SETTINGS".</b>. Then click "EXIT" and you're done.
</P>
<a id="sketchfab_alternate">
If for some reason you can't get the "Publish to Sketchfab" feature to work for you,</a> or you want to use anything but the default export options, there's another way to upload to Sketchfab that's only a little more work. Follow <a href="https://help.sketchfab.com/hc/en-us/articles/206738956-Minecraft-Mineways">these instructions</a> or go through the step-by-step below.
<P>
<b>1) Open your World in Mineways</b>, then, select the area for exporting (hold right mouse button and drag the rectangle), and choose "File | Export Model for Rendering" from the menu.
</P>
<P>
<b>2) "File | Export Model for Rendering"</b> and save the file as a Wavefront Object (.obj) to a folder of your choice. Let's call it myobject.obj or whatever you like. In the dialog with the export settings click on the option in the upper left click on "Create a ZIP file containing all export model files". Click "OK".
</P>
<P>
<b>3) Sign up for an <a href="https://sketchfab.com/">account on Sketchfab</a></b> if you haven't already, then upload the zip file you created by clicking on the "UPLOAD" button in the upper right. A dialog pops up; click on "CHOOSE FILE" and upload the .obj.zip file you created. Click "CONTINUE".
</P>
<P>
<b>4) Fill out the form as you wish.</b> It's nice to add "minecraft" and "mineways" tags, so others can find your model. It's also nice to "Allow download", if you like.
</P>
<P>
At this point the steps are much the same as above, starting at step #5. The main difference is that your uploaded model is not published by default; for the last step you'll want to click "SAVE AND PUBLISH," then "EXIT."
</P>
<P>
One other thing you may wish to do is material cleanup. On the Sketchfab Materials tab (the center one) is the "Faces Rendering" option at the bottom. You may notice some "z-fighting" for objects such as sunflowers, where the two textures on each side of the flower fight each other. Choose a material at the top and select "Single sided" for that material. This will make the object look better.
<P>
An irregularity: if you download your uploaded model from Sketchfab, it may not display correctly. The short version is that you probably have to comment out the "map_d" field in the .mtl file for the model. Some viewers incorrectly grab the red channel instead of the alpha channel from the four-channel map that Sketchfab uses for compactness.
</P>
<P>
Physically based rendering support: Sketchfab does recognize addition material types, see <a href="https://help.sketchfab.com/hc/en-us/articles/202600873-Materials-and-Textures#textures-auto-pbr">their page</a> for details. Note that when you use individual textures and "custom material" for OBJ export, you get these extra files, if available (or derived, such as the emission textures). However, the naming doesn't quite match for normal and emission textures currently; it does match for specular ("_s") and metalness ("_m").
<P>
Here's an example of Sketchfab in action, a model I uploaded. Click on the window and you can interact with it. More models <a href="https://sketchfab.com/erich/folders/mineways">here</a> and <a href="https://sketchfab.com/tags/minecraft">here</a>.
<P>
<div>
<iframe width="1280" height="960" src="https://sketchfab.com/models/a4ef44e93ef54ac1a8cfb4b490089039/embed"></iframe><p style="font-size: 13px; font-weight: normal; margin: 5px; color: #4A4A4A;">
    <a href="https://sketchfab.com/3d-models/sentinel-castle-a4ef44e93ef54ac1a8cfb4b490089039?utm_medium=embed&utm_source=website&utm_campain=share-popup" target="_blank" style="font-weight: bold; color: #1CAAD9;">Sentinel Castle</a>
    by <a href="https://sketchfab.com/erich?utm_medium=embed&utm_source=website&utm_campain=share-popup" target="_blank" style="font-weight: bold; color: #1CAAD9;">erich</a>
    on <a href="https://sketchfab.com?utm_medium=embed&utm_source=website&utm_campain=share-popup" target="_blank" style="font-weight: bold; color: #1CAAD9;">Sketchfab</a>
</div>

<HR>
<H2 id="print_services">
3D Print Services
</H2>
If you want to make a 3D print of a model, the easiest way is to use a 3D print service such as <a href="http://shapeways.com">Shapeways</a> or <a href="http://sculpteo.com">Sculpteo</a>. The main differences are cost, quality, and speed of delivery. Shapeways is almost always less expensive, Sculpteo offers faster delivery and better supports the <a href="#lesser">"Export lesser blocks"</a> option, which lets you print out slabs, steps, fences, and other smaller bits in your model. <a href="https://www.3dhubs.com/">3D Hubs</a> also has some users with full-color printers, so may be both competitive and fast. There are other 3D print services for consumers, such as <a href="http://i.materialise.com/">i.materialise</a> and <a href="http://ponoko.com">Ponoko</a>, but currently these two do not offer fully-textured 3D printing, just solid color blocks. There are many services offering single-color (i.e., single material, such as plastic) prints, such as any of the above or <a href="https://all3dp.com/1/best-online-3d-printing-service-3d-print-services/">those on this list</a>. Finally, here's <a href="https://all3dp.com/2/minecraft-3d-printing-guide/">a little collection of articles</a> on 3D printing Minecraft.
<P>
<H3 id="shapeways">Shapeways</H3><p>
<a href="https://www.shapeways.com"><img id="productLogo" src="images/shapeways_icon.jpg" alt="Shapeways icon"></a>
<P>
After <a href="http://www.shapeways.com/register">creating an account</a> (and <a href="http://www.shapeways.com/myshop">creating a shop</a>), go to the <a href="http://www.shapeways.com/upload/">upload page</a>. Or, if you go through the Shapeways site in other ways, choose "Get a quote." Choose a file for upload - <B>you must pick the .ZIP file for your model</B> that you created with Mineways, using 3D print export, e.g., "mymodel.wrl.zip". You also don't need to change the Unit of Measure: "millimeters" is the default and is what Mineways always outputs. Push the upload button.
<P>
Once you've uploaded, you can preview the model in the window to make sure it looks correct. You can also order from this page by choosing the material. For a full color print you want to pick "Sandstone", the last material on the list. For options, choose "Full Color" and then, your choice, "Glossy" or "Natural." If the material is not selectable, there may be a problem with your model. Select "Tools" near the top, next to the name of your file. You can now select the material you want and the page will show you exactly what test is failing, such as wall thickness or bounding box (model size).
<P>
Note there's a fixed cost per order. Be careful, however: you normally cannot cancel your order once placed. After you've made an order, the waiting begins, sometimes 2-3 weeks.
<P>
If you later want to make your product for sale or otherwise modify it, go to <a href="https://www.shapeways.com/mymodels">My 3D Models</a>. Click on the three dots to the right of a model a choose the option "Edit Product."
<P>
See <a href="http://www.shapeways.com/shops/mineways">my humble shop</a> as an example of how I set up various models.
<P>
<H3 id="sculpteo">Sculpteo</H3><p>
<a href="https://www.sculpteo.com"><img id="productLogo" src="images/sculpteo_icon.jpg" alt="Sculpteo icon"></a>
<P>
Go to the <a href="http://www.sculpteo.com">Sculpteo site</a> and register for an account.
<P>
<B>WARNING:</B> Currently (as of 2021) Sculpteo no longer supports textured, colored output for objects. I'm leaving these instructions in place, though they're unlikely to do you much good.
<P>
In Mineways, you normally want to export to Wavefront OBJ when exporting to print, using the "Sculpteo" file type. Sculpteo also accepts VRML2 files, but the OBJ exporter sets some useful defaults for Sculpteo. One major advantage of Sculpteo is that they support the <a href="#lesser">"Export lesser blocks"</a> option, which allows you to export slabs, stairs, fences, doors, and other smaller objects. Please <a href="#lesser">read the documentation</a> for that option before using it. Also note that when you export, the price shown is the Shapeways price (more or less); Sculpteo prices tend to be about a third higher overall.
<P>
Once you have your export file ready, on the <a href="http://www.sculpteo.com/en/">home page</a> click on the <a href="http://www.sculpteo.com/en/upload_design/3D/">Upload a 3D file</a> button in the upper right (you can also go to <a href="http://www.sculpteo.com/en/my_account/">your account</a> and find the <a href="http://www.sculpteo.com/en/upload_design/3D/">"Upload a new design"</a> link).
<P>
On the <a href="http://www.sculpteo.com/en/upload_design/3D/">upload page</a> choose a file - <B>you must pick the .ZIP file for your model</B>. Adjust the design name, description, keywords, and categories as you wish (personally, I fill these in later, when I'm sure the model is a keeper). Note you can also add French translations; I use <a href="https://translate.google.com/">Google Translate</a>. Agree to the terms of use at the bottom and click "OK". Wait a bit.
<P>
You should then get a page showing your model has been uploaded. You can interact with it in the viewport using left-mouse, right-mouse, middle-mouse, and scroll wheel. Pro tip: note that rotating by going up and down near the edge of the window gives a different rotation than going up and down in the middle. This can help you adjust the "up" direction.
<P>
You now have a range of options. One service worth checking is "Thickening" in the viewport. This view shows you whether your model is printable. Red areas are likely too thin to print properly.

<HR>
<H2 id="scripting">
Scripting
</H2>
By using "Import Settings" you can make Mineways do all sorts of things quickly. You can also temporarily modify blocks when exporting. It's easier to use than you might think, <a href="scripting.html">read about it here</a>.

<HR>
<H2 id="stuff">
Related Resources
</H2>
Here are some related (free) tools that are handy, collected in one spot:
<UL>
<LI>The <a href="#g3d">G3D viewer</a> is excellent for previewing 3D OBJ files for rendering (sorry, not VRML or STL), as its support for cutouts is superior to the <a href="http://meshlab.sourceforge.net/">MeshLab</a> viewer. It also includes real-time shadows and reflection-mapped water, as well as built-in screen and movie capture (only the viewer32.exe version has video capture). Models also load faster. Downside: on weaker GPUs it can be slow, and it doesn't work when <a href="#fcst">exporting individual textures</a>. Some examples <a href="http://imgur.com/a/B8DuU">here</a>.
<LI><a href="http://meshlab.sourceforge.net/">MeshLab</a> helps you convert, simplify, and smooth meshes, among a huge number of other operations. It's not the best for displaying textures.
<LI><a href="https://www.amuletmc.com/">Amulet</a> lets you convert from and to Bedrock and Java worlds, and lets you edit them. Also, open source, and actively maintained. For example, you could trim away objects near your model to make a cleaner export. You can also read in model schematic files you've downloaded. To use a schematic with Mineways, import the schematic into an empty world and save the world, then use Mineways on that world. (Supercedes <a href="http://www.mcedit-unified.net/">MCEdit Unified</a>.)
<LI>Use the <a href="https://github.com/mircokroon/minecraft-world-downloader">Minecraft World Downloader</a> to download chunks from multiplayer worlds, which you can then use with Mineways.
<LI><a href="https://minecraft.curseforge.com/projects/worldedit">WorldEdit</a> is another mod that lets you make large edits to your world. It can load and save (old style and new) .schematic/.schem files. It also allows a huge number of modeling operations, including <a href="http://www.reddit.com/r/Minecraft/comments/12lzmb/my_first_hour_with_worldedit/">procedurally-generated models</a>. It differs from Amulet in that it is a plug-in to Minecraft, while Amulet is standalone.
<LI><a href="https://www.curseforge.com/minecraft/mc-mods/litematica">Litematica</a> is a tool for reading, examining, and writing new-style schematic (.schem) files and pasting them into your world.
<LI><a href="https://intellectualsites.github.io/download/fawe.html">FAWE</a> is an alternate to WorldEdit, part of the Spigot system.
<LI>There is also a browser-based utility to <a href="https://puregero.github.io/SchemToSchematic/">convert old schematic files to new ones</a>, if that's a help.
<LI><a href="https://voxelsniper.fandom.com/wiki/VoxelSniper_Wiki">VoxelSniper</a> is another Bukkit addon for servers, providing a wide range of editing abilities.
<LI><a href="https://www.mineimator.com/">Mine-imator</a> is a self-contained Minecraft video animation system. It can read in and view schematic files, among much else.
<LI><a href="https://www.autosaved.org/Spritecraft">Spritecraft</a> converts an image to a schematic file, allowing you to easily create pixel art.
<LI><a href="https://www.patrickmin.com/minecraft/">Binvox</a> goes the other direction, letting you turn a model file into a voxelized representation, suitable for building or export to a schematic file. I have a <a href="https://erich.realtimerendering.com/minecraft/public/vox_package.zip">quick-start Binvox package</a> for Windows: binvox, viewvox, GLUT DLL, two sample 3D models, and batch files to run the programs. Documentation <a href="https://minecraft.wiki/w/Programs_and_editors/Binvox">here</a>. For more info, see the <a href="https://www.minecraftforum.net/forums/mapping-and-modding-java-edition/minecraft-tools/1260560-converting-a-3d-model-to-building-plans">forum thread</a> and <a href="https://www.minecraftforum.net/forums/archive/tutorials/928366-misc-build-any-3d-model-in-minecraft-easily-22-9">related forum thread</a>. I used it to make the <a href="https://www.minecraftforum.net/forums/mapping-and-modding-java-edition/minecraft-tools/1260560-converting-a-3d-model-to-building-plans#p893068">teapot</a>, <a href="https://get.google.com/albumarchive/101252446341510025731/album/AF1QipNHDukcTXoMKMFvm4hGw5cJMudS__Z6usPZTq-n/AF1QipO3nq2mALywVpvTa8HLjNvmJQn0XUfZVdWqecey">guardian</a>, and <a href="https://get.google.com/albumarchive/101252446341510025731/album/AF1QipNHDukcTXoMKMFvm4hGw5cJMudS__Z6usPZTq-n/AF1QipNewSsuMPCe150YETklmtIRBM7PolqUNkC47lns">hopper</a>, among other models.
<LI><a href="http://www.minddesk.com/">Qubicle</a> costs money, but has some nice functions. It is a set of voxel-based utilities, including an editor and a voxelizer that computes a good color for the voxel from the material.
<LI><a href="http://craftmastersoftware.com/">CraftMaster</a> has developed a program for voxelization specifically aimed at Minecraft, and that exports directly to Sketchfab.
<LI><a href="https://www.tinkercad.com/">TinkerCAD</a> is an online CAD program. You can now <a href="https://blog.tinkercad.com/2013/08/15/tinkercraft">export <i>to</i> Minecraft from it</a> - try the "Download for Minecraft" feature, <a href="https://blog.tinkercad.com/2016/03/10/5707">now with materials</a>. You can also search for <a href="https://www.tinkercad.com/search/?q=minecraft">Minecraft-related objects</a>. See <a href="https://www.youtube.com/watch?v=ehtstka7vSs">this video</a> for how to use it and export.
<LI><a href="http://mblaine.github.io/BiomePainter/">Biome Painter</a> lets you modify the biomes of your world. If you get it, make sure to use the "Help" menu "Check for updates" feature.
<LI>More Minecraft tools <a href="http://minecraft.wiki/w/Editors">here</a>.
</UL>

<h3 id="models">Stuff to Print and Render</h3>
Want something to try Mineways on? There are a number of sites with cool downloadable models and worlds, including:
<UL>
<LI><a href="http://www.planetminecraft.com/resources/projects/any/?order=order_popularity">Planet Minecraft projects</a> - all sorts of great stuff to print, sorted by popularity.
<LI><a href="http://www.minecraftworldmap.com/">Minecraft World Map</a> has a large number of worlds and includes a nice Google Maps preview feature.
<LI><a href="https://wiki.openstreetmap.org/wiki/Minecraft">Open Street Map</a> has a Minecraft-related page of resources. Many people have made all sorts of maps, including one of <a href="https://earth.motfe.net/">the entire earth</a>.
</UL>
You could get a copy of our world, <a href="http://vokselia.com/">Vokselia</a>. I've also got a <a href="http://www.shapeways.com/shops/mineways">Shapeways shop</a>, where you can view photos of different 3D prints and download the model files themselves. You could also buy any of these (though you should just make your own!).
<P>
For something amazing, <a href="https://www.youtube.com/watch?v=ldiISyKkGl8">check this out</a> (more <a href="http://www.youtube.com/watch?v=RzDm9e28D0M">here</a>)- meta! Double-meta, I exported this model using Mineways, <a href="http://www.shapeways.com/model/417909/3d_printer.html?key=7c0a7947033d4539c38aae232616d217">check it out</a>.


<h3 id="packages">Other Packages</h3>
<p>
Mineways is not the first to offer a Minecraft model exporter, nor necessarily the best for export for rendering. Minepedia has a <a href="http://minecraft.wiki/w/Programs_and_editors/3D_Exporters">page about exporters</a>. Here's more information on the ones I know about and related services.
</p><ul>
<li><a href="http://www.jmc2obj.net/">Jmc2obj</a> is a Java-based (so multi-platform) exporter for rendering. It is actively developed, but I find I can no longer quite get the textures to attach properly to the surfaces. You do need to export textures first, typically giving you a single texture to work from, which is then applied to the model. If you get it going (let me know the secret), it has some nice features, nicer than Mineways in some ways.

</li><li><a href="https://theduckcow.com/dev/blender/mcprep/">MCprep</a> is a Blender python script that can improve model quality of Mineways and jmc2obj exports. <a href="https://youtu.be/XndRsS6KWkw">Here's my short video</a> on how to install and use it for that. But, it does much more than that, including letting you add mobs, swap in custom 3D meshes for objects, change character skins, etc.

</li><LI><a href="https://chunky.llbit.se/">Chunky</a> is an amazing self-contained path-traced renderer: choose your chunks, load them, set the view and let 'er rip. Definitely try out the various options.

</li><LI>In the Bedrock edition of Minecraft <a href="https://educommunity.minecraft.net/hc/en-us/articles/360047117612-Exporting-in-3D-">structure blocks</a> can be used to export to the glTF format. Also see <a href="https://learn.microsoft.com/en-us/minecraft/creator/documents/introductiontostructureblocks#3d-export-mode">here</a>.

</li><li>OptiFine, Sonic Ether's Unbelievable Shaders, and related resource packs are definitely worth checking out. <a href="#renderTips">Find information here</a>.

</li><li><a href="https://www.mineimator.com/">Mine-imator</a> lets you directly import from Minecraft and animate. It's pretty impressive! However, it doesn't export to 3D model files, so I guess I need to keep working on Mineways.

</li><li><a href="https://ephtracy.github.io/">MagicaVoxel</a> read Minecraft schematics and gives a nice rendering of them. It's best for large models, as it converts everything to colored blocks, no details. There is also <a href="https://github.com/Zarbuz/FileToVox">code to convert to its .vox format</a>.

</li><li><a href="http://blokify.com/">Blokify</a> is a free Minecraft-style modeler for the iPad. I found placing individual blocks a bit dicey, but that's because they've built in ways to fill in lines of blocks in a single go. You can email yourself the resulting STL file (though it didn't work for me). The blocks used are geometrically textured, so 3D print out with more than just simple flat surfaces.

</li><li><a href="https://itunes.apple.com/us/app/voxel/id333186489?mt=8">Voxel</a> is an iPad app that lets you design in voxels and send your model directly to Sculpteo for printing.

</li><li><a href="http://www.schematicstore.com/shop">Minecraft Schematic Store</a> - buy and sell Minecraft schematics (note that Mineways has an Export Schematic option).

</li><li><a href="http://minetoys.com/">MineToys</a> offers 3D prints of your character. More on how MineToys works <a href="http://www.shapeways.com/blog/archives/1105-Minetoys-3D-Print-Your-Own-Minecraft-Character-for-Your-Desktop.html">here</a>.


</UL>

<h4>Older Stuff</h4>
Mostly defunct, but FYI and because I like to keep track.

<UL>
</li><li>The <a href="https://minecraftanimation.fandom.com/wiki/Minecraft_Animation_Wiki:Home">Minecraft Animation Wiki</a> is mostly about animations made by others, but has a few pages of direct interest to creators, such as <a href="https://minecraftanimation.fandom.com/wiki/List_of_commonly_used_Minecraft_animation_programs_and_their_foremost_users">who uses what programs</a> for Minecraft animation.

</li><li><a href="http://www.printcraft.org/">Printcraft</a> is a cool idea: you go onto this server, build something with friends, then push the Print button and an STL file of your build is sent to you. No muss, no fuss. Meant for home and school 3D printers for the most part, since the STL comes without any colors.

<li><a href="https://steamcommunity.com/sharedfiles/filedetails/?id=238087985">SourceCraft</a> creates maps for <a href="https://en.wikipedia.org/wiki/Source_(game_engine)">Valve's Source engine</a>, for games such as Team Fortress 2 and Garry's Mod, via Minecraft.

</li><li><a href="https://github.com/webbukkit/dynmap/wiki/Exporting-World-Data-in-Wavefront-OBJ-Format">dynmap</a> has an option to export blocks, even custom blocks, to the OBJ format. I haven't tried it; let me know how you find it.

</li><li><a href="http://randomsamples.info/project/mineblend/">Mineblend</a> - an add-on that extracts data from a world directly into Blender. Defunct, no updates since 2015, but mentioned because I'm a completist.

</li><li><a href="http://www.minecraftprint.com/">MINECRAFT.print()</a> - these guys were first to print Minecraft models, all glory to them! You run some python scripts from a command line to take a volume and turn it into an STL file. There's a hollowing function (their Companion Cube is not solid, thank heavens). Cody pointed out <a href="http://www.youtube.com/watch?v=Sku5jOTwCP8">this nice little color export</a> someone did using their scripts. All that said, the python script is years out of date and won't work on Minecraft version 1.2 on (Anvil format).

</li><li><a href="https://software.ultimaker.com/">Cura</a>, the software for the Ultimaker 3D printer, has <a href="https://groups.google.com/forum/#!topic/ultimaker/6FdlKOoJap0">a Minecraft import option</a>, step-by-step instructions <a href="http://www.instructables.com/id/3D-Print-Minecraft/?ALLSTEPS">here</a>. Again, ancient, but I like to keep track.

</li><li><a href="http://www.thingiverse.com/thing:9940">Minecraft structure planner</a> - written in Ruby, this is a basic exporter of STL files from schematics. It's the first program I know to export color models from Minecraft for 3D printing.

</li><li><a href="https://www.minecraftforum.net/forums/mapping-and-modding-java-edition/minecraft-mods/2520465-world-downloader-mod-create-backups-of-your-builds">Minecraft world exporter</a> (<a href="http://www.minecraftforum.net/topic/1444862-132-world-downloader-mod/">old thread</a>) - Mineways works only with worlds you have locally on your computer. If you can't download the multiplayer world you're in, use this mod to suck in whatever chunks you see.

</li><li><a href="https://eihort.en.softonic.com/">Eihort</a> was an easy-to-use standalone program that lets you see and explore much more of your world at once.

</li><li><a href="https://github.com/FalconNL/mc2obj/downloads">mc2obj</a> (documentation and source <a href="https://github.com/FalconNL/mc2obj">here</a>) - mentioned mostly for historical purposes, it has been superseded by jmc2obj, mentioned earlier. This utility pulls in the specified Minecraft world data and makes an OBJ file. It <a href="http://www.reddit.com/r/mcobj/comments/k4se7/alpha_testers_wanted_for_mc2obj_an_exporter_that/">includes true geometry</a> vs. Mineways' whole block orientation.

</li><li><a href="https://github.com/quag/mcobj/downloads">mcobj</a> - again mentioned for historical purposes, the first-known exporter. There is a <a href="http://www.reddit.com/r/Minecraft/comments/jdkag/how_to_import_your_minecraft_world_into_blender/">Blender tutorial</a> and a <a href="http://www.reddit.com/r/mcobj/">gallery of results</a>. It has command-line and <a href="http://code.google.com/p/mcobj-gui/">dialog</a> versions. <a href="https://github.com/quag/mcobj">Source available</a>. It didn't apply textures.

</li><li><a href="http://www.thingiverse.com/search?q=minecraft&sa=Search">Thingiverse</a> - this site contains a bunch of Minecraft-related models if you are looking for things to print. I think <a href="https://www.thingiverse.com/thing:30820">this one</a> is brilliant.

</li><li><a href="http://www.wired.com/2012/11/augmented-minecraft-reality/">Minecraft Reality</a> sadly doesn't seem to be around any longer, but the demos of Minecraft objects inserted into the real world are cool to look at. It beat the (now-defunct) <a href="https://www.minecraft.net/en-us/article/minecraft-earth-coming-end">Minecraft Earth</a> to the punch by seven years.

</li>
</ul>

<HR>
<h2 id="mcpe">Minecraft Bedrock Support</h2>

Mineways works on only Minecraft <a href="https://minecraft.wiki/w/Java_Edition">Java (aka Classic) Edition</a> worlds. You can determine whether you're using this Classic Edition or the Bedrock Edition by <a href="https://funcaptains.com/blog/java-or-bedrock-what-minecraft-version-do-i-have">following these steps</a>.
<P>
This section describes how to convert a Minecraft Bedrock world to a Minecraft Java Edition one so that Mineways can read it. <B>NOTE:</B> No converter can convert Bedrock Marketplace worlds, see <a href="https://www.universalminecraftconverter.com/resources/articles/converting-marketplace-maps">this explanation</a>.
<P>
Minecraft for Windows 10, also known as the <a href="https://minecraft.wiki/w/Bedrock_Edition">Bedrock Edition</a>, uses an entirely different database format for its worlds, called <a href="https://github.com/Mojang/leveldb-mcpe">LevelDB</a>. If your level.dat files are located in a directory with the path ..."\AppData\Local\Packages\Microsoft.Minecraft"... in it, or have weird directory names like "ZAD1Xfl9AAA=", that's a Bedrock Edition save.
<P>
The options I know of are:
<UL>
  <LI><a href="https://www.amuletmc.com/">Amulet</a>, which works on Windows, Mac, and Linux. The documentation is <a href="https://github.com/Amulet-Team/Amulet-Map-Editor/blob/master/amulet_map_editor/programs/convert/readme.md">here</a>. Upside: converts 1.17+ worlds. Downside: a bit slow and looks like it locks up at times.
  <LI><a href="https://chunker.app/">Chunker</a> - entirely online; upload your world from Bedrock, download it for Classic Minecraft.
  <LI><a href="https://web.archive.org/web/20210513191001/http://www.mcctoolchest.com/Download">MCC ToolChest PE</a> - a little quirky, but free. Sadly, it seems to have disappeared in June 2021; we link to the archived site where you can still download it (should work for Minecraft 1.16 and earlier).</LI>
  <LI><a href="https://www.universalminecraftconverter.com/">Universal Minecraft Converter</a> - evidently more reliable than the MCC ToolChest, but is a (rather pricey) subscription service.</LI>
</UL>

<P><b>Short Amulet instructions:</b> <a href="https://www.amuletmc.com/">Amulet</a> converts, but need to have a world to save into. Make an empty world in Java (Classic) Minecraft, easiest is to make a superflat world. Start Amulet and make the window much larger (this is important for usability - in general, resize all windows in Amulet to be larger, so you can see all the controls). Pick "Open World". Pick "Bedrock" and select the world you want to convert. Click the "Convert" tab along the left edge. "Select Output World" and choose the empty superflat world you made at the start. Click the "Convert" tab at the bottom (a large world can take a fair bit of time to convert - patience). If you don't see the "Convert" tab, you need to resize the Amulet window to make it visible.

<P><b>Longer Amulet instructions:</b> There are any number of ways you can go wrong with Amulet, so here are detailed instructions. I use some directory paths on my machine as examples. Yours are almost assuredly going to be different. Here goes:
<OL>
<LI>Start up Java Minecraft and make an empty world, let's call it <a href="https://www.planetminecraft.com/project/nvidia-rtx-winter-world/">NVIDIA RTX Winter World</a>, a free Bedrock map I'll use as an example. This is the world you’ll convert into. The empty world is best as a superflat, but it doesn’t matter much (other than avoiding wasting time), since we’re going to delete all the data from it manually.
<LI>In Windows Explorer, go into wherever the world was created, e.g., C:\Users\ehaines\AppData\Roaming\.minecraft\saves\NVIDIA RTX Winter World. Go into the region subdirectory. Delete the four files there, r.-1.-1.mca etc. You now have an empty world you will now fill with the conversion from Bedrock. This step is not strictly necessary, but I like knowing that there aren’t any extra chunks sitting around.
<LI>Download the <a href="https://www.planetminecraft.com/project/nvidia-rtx-winter-world/">Bedrock Winter World</a>. In theory you could double-click the Winter World download and it’ll install into Bedrock Minecraft (if you have it). I did this, but it didn’t seem to work the first time I tried; I couldn’t see the world.
Alternately, right-click the s.zip.mctemplate file you downloaded and open with WinRAR.
Unzip the contents into a directory called something like "NVIDIA_RTX_WinterWorld" created in some temporary directory, say C:\temp or your Downloads directory. Alternately, and not required, but in theory if you have Bedrock Minecraft installed, you could unzip it into the save directory, something crazy like directory C:\Users\ehaines\AppData\Local\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\LocalState\games\com.mojang\minecraftWorlds (or similar - basically, search for "minecraftWorlds" on your machine to find this well-buried directory).
<LI>After downloading <a href="https://www.amuletmc.com/">Amulet</a>, unzip it into some directory in your personal area. I tried putting it in C:\Program Files\Amulet, but it then had permission problems when run. I ended up with putting it in my C:\Users\ehaines\Documents\Amulet directory.
<LI>Start amulet_app.exe in that directory (double-click, or start in a CMD window so you can see any problems). Make it full screen.
<LI>In Amulet, pick Main Menu (if not there by default) and Open World.
<LI>In the upper left, you have a choice. You want to open the world you want to convert. If you just unzipped the Bedrock world into C:\temp, use the "Open other world" button and navigate to and choose "c:\temp\NVIDIA_RTX_WinterWorld". If you instead put the world into your Bedrock saves, click the down-arrow next to Bedrock and then pick Christmas Adventure RTX.
<LI>Now, along the left edge of Amulet, pick the Convert tab, then the Select Output World button in the middle, and pick the empty Java world you made earlier.
<LI>Wait a bit. You should see the converted files in your Minecraft Java save directory, e.g., C:\Users\ehaines\AppData\Roaming\.minecraft\saves\NVIDIA RTX Winter World\region or wherever your Java world is. You can also look at the Amulet CMD output window for errors. I've found it's usually an all-or-nothing affair. Amulet either succeeds or fails on everything, for whatever reason.
<LI>Once done, you can now read this world into Mineways. Start Mineways and pick the world.
</OL>
Note: Amulet can be a bit flaky at times, e.g., I've seen biomes not get generated. If you have problems with the converted world, try opening it in Minecraft itself. Doing so can clean up problems.

<P><b>MCC ToolChest PE instructions:</b> Download it, install, and run. If you get an error about some missing DLL, you may also need to install the <a href="https://web.archive.org/web/20210513191001/http://www.mcctoolchest.com/Download">VS 2015 C++ Runtime</a>. Once running, do the following in MCC ToolChest - PE:
<OL>
<LI>Select "File | Open" and choose the Bedrock world you want to convert. It should read in, and you'll see "level.dat", "players", etc. listed on the left. If you don't see the world you want to convert, you'll need to (somehow) get it to your PC and find its path via "File | Open" and "Select Folder."
<LI>Select "Tools | Convert -> To Java." A large dialog box appears.
<LI>For the "Minecraft Java world folder" at the top put a path where you want to create the converted world. If you leave it the default "\" you'll get a mysterious error. As an example, I use "C:\Users\erich\AppData\Roaming\.minecraft\saves\bedrock_test\" - my user name is "erich" and the world directory name I want for the converted world is "bedrock_test." By putting the path "...\AppData\Roaming\.minecraft\saves\..." I am putting the converted world in the default directory for Minecraft Java worlds, which means it will then show up in Mineways' list of worlds automatically.
<LI>Halfway down on the left of the dialog look for "Convert into." Change this from "Empty Dimension" to "Empty World."
<LI>Click "Convert" at the bottom of the dialog. Cross fingers.
</OL>
If there were no errors, great, and you should see your converted world in your saves directory, and Mineways can then convert it. In Mineways you should look for the directory name of the world on the right-hand side of the "File | Open World" list of worlds.
<P>
If you did get some error, try the "Help" button, it might actually help. I found not setting "Convert into" properly or not giving a good directory path can give errors.
<P>
If you need more help, <a href="https://web.archive.org/web/20200625020835/https://mcctoolchest.weebly.com/tutorial.html">this older site</a> <i>might</i> help.
<P>
Note that this tool can also convert from Java to Bedrock, if that's of interest. <a href="https://youtu.be/LcqD1FPcF5o?t=61">This video</a> goes through most of the steps for that process. There's also <a href="https://www.nvidia.com/en-us/geforce/guides/minecraft-rtx-world-conversion-guide/">this detailed guide</a>, which filters out bad data.

<P>
There are other, lesser converters out there. Another possibility is to find some way to convert your model to the <a href="https://minecraft.wiki/w/Schematic_file_format">Schematic file format</a>, which Mineways also reads. For consoles, there is also <a href="https://www.microsoft.com/en-us/p/andromeda-converter-for-minecraft/9nrrvm1vrnjr">this poorly-rated one</a> that looks unlikely to work.


<h3 id="structure_block">Structure Block Export</h3>
You can also export 3D data from (only) the Bedrock Edition directly to a 3D model file format, the glTF binary format. Give yourself a structure block in Minecraft by typing the command "/give @s structure_block". Place this block near the area you want to export, then right-click it. <a href="https://minecraft.wiki/w/Structure_Block#3D_Export">A dialog comes up</a> in which you can specify the size of the export (never larger than 32x32x32, even if you set it higher), the offset, and the file name to export to, along with some other options. This file can then be viewed by the built-in Paint 3D program and be converted and loaded by many other programs in the <a href="https://www.khronos.org/gltf/">glTF ecosystem</a>.

<HR>
<h2 id="shortcuts">Keyboard Shortcut Keys</h2>
The quick reference of handy shortcuts is <a href="reference.html#mak">here</a>, with the full list <a href="reference.html#shortcuts">here</a>.
Most operations in Mineways can be done with the mouse: left button drag and mouse wheel for viewing, middle mouse click for setting the depth to whatever is at that location, right mouse selects a region to export. If you don't have a right mouse button, hold Control down and use the left mouse button. Instead of using the height sliders at the top, using the mouse wheel with the Control key down changes the depth, with Shift down changes the max. height (this second mode can be slow, since the map is regenerated). More on mouse controls in the <a href="#select">Selection section</a>.

<HR>
<h2 id="blocks">Block Types Supported</h2>
There are two main modes of export: for rendering and for 3D printing. These mainly differ in that some blocks, such as flowers, are not things that can be printed as is. For 3D printing, the <a href="#lesser">"Export lesser blocks"</a> option has a major effect on what gets exported. Note that this option is on by default for rendering; turning it off will turn a number of blocks into "full blocks" instead of true geometry, for a more abstract look (but, no one ever turns it off). Finally, for the "lesser blocks" option there's a <a href="#lesser">"fatten" suboption</a>, which makes fences, fence gates, doors, free-standing sign posts, and pressure plates thicker, so they're more likely to print without snapping off.
<P>
If you want to test particular blocks to see what they look like, use the <a href="#blocktestworld">"[Block Test World]"</a> and the block IDs to select and export whatever block types in whatever mode you want. Alternately, you could <a href="https://www.planetminecraft.com/resources/projects/?keywords=texture+test+world">find a texture test world</a> you like, such as <a href="https://www.planetminecraft.com/project/texture-test-world-3122931/">this one</a>.
<P>
In Minecraft itself you can also <a href="https://minecraft.wiki/w/Debug_mode">create a Debug block world</a> in Minecraft itself (short version: "Create New World", click "World" tab middle top, hold Alt and keep clicking on "World Type:" until "Debug Mode" comes up) - note Mineways doesn't support everything, as noted below. If you are using <a href="https://minecraft.wiki/w/Debug_Stick">the debug stick</a> or commands to set a state for a block that is not valid in a normal world, don't expect it to work. Desperate? Try <a href="https://www.jmc2obj.net/">jmc2obj</a> - they do some fancy stuff, like create banner textures.
<P>
Here's what Mineways exports as of version 5.01:
<div>
<iframe width="1280" height="960" src="https://sketchfab.com/models/53f7adafaca44a5b8ef1692a47fa03ac/embed"></iframe><p style="font-size: 13px; font-weight: normal; margin: 5px; color: #4A4A4A;">
    <a href="https://sketchfab.com/models/53f7adafaca44a5b8ef1692a47fa03ac?utm_medium=embed&utm_source=website&utm_campain=share-popup" target="_blank" style="font-weight: bold; color: #1CAAD9;">Material Sampler</a>
    by <a href="https://sketchfab.com/erich?utm_medium=embed&utm_source=website&utm_campain=share-popup" target="_blank" style="font-weight: bold; color: #1CAAD9;">Eric Haines</a>
    on <a href="https://sketchfab.com?utm_medium=embed&utm_source=website&utm_campain=share-popup" target="_blank" style="font-weight: bold; color: #1CAAD9;">Sketchfab</a>
</p>
</div>
<P>
Mineways does not support export of characters, creatures, sign text, paintings, or banner patterns, <a href="#blocks">among other things</a>.
<P>
All "full blocks" (stone, dirt, wood, on and on) export the same under all modes. The table below outlines the rest. "Flatten" means a billboard, such as a flower, or small object, such as a torch or lever, is flattened to be a decal on the block below, since such objects are too thin to be 3D printed.
<TABLE id="fullBlocksTable" border="1">
<tr>
<td>
<B>Block Type and ID (for 1.12 and earlier)</B>
</td>
<td>
<B>Render Export</B>
</td>
<td>
<B>Print Export</B>
</td>
<td>
<B>Print w/<a href="#lesser">"Lesser"</a></B>
</td>
<td>
<B>Notes</B>
</td>
</tr>

<tr>
<td>
Saplings (#6)<br>Tall Grass (#31)<br>Dead Bush (#32)<br>Flowers (#37, #38, #175)<br>Mushrooms (#39, #40)<br>Pumpkin and Melon Stems (#104, #105)
</td>
<td>
<center>Billboards</center>
</td>
<td>
<center>Flattened</center>
</td>
<td>
<center>Flattened</center>
</td>
<td>
Pumpkin and melon stems do not darken with maturity when exported from Mineways. When "Split by block type" is set, separate (identical - you may edit these) materials are output for each age of stem, 0 through 7, e.g., "Pumpkin_Stem_age_5" is nearly fully mature.
</td>
</tr>

<tr>
<td>
Water (#8)<br>
Stationary Water (#9)<br>
Lava (#10)<br>
Stationary Lava (#11)
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Full block</center>
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
The bottommost texture copy found in Minecraft's water_still.png and lava_still.png are used for these blocks. The water_flow.png and lava_flow.png bottommost left tiles are used only for vertical walls. For walls behind glass blocks, water_overlay.png is used. Bubble columns are identified as a subtype of Stationary Water when output with "split by block type" but have no effect on rendering otherwise.
</td>
</tr>

<tr>
<td>
Bed (#26)
</td>
<td>
<center>Always red, legs not solid</center>
</td>
<td>
<center>Stretched to full block</center>
</td>
<td>
<center>Area under bed is solid</center>
</td>
<td>
Only the red colored bed is supported (supporting all beds results in an excessive number of textures dedicated to beds).
</td>
</tr>

<tr>
<td>
Rails (#27, #28, #66)
</td>
<td>
<center>Yes</center>
</td>
<td>
<center>Flattened to block sides</center>
</td>
<td>
<center>Yes, slope block added</center>
</td>
<td>
</td>
</tr>

<tr>
<td>
Cobweb (#30)
</td>
<td>
<center>Crossed billboard</center>
</td>
<td>
<center>Block with texture</center>
</td>
<td>
<center>Block with texture</center>
</td>
<td>
</td>
</tr>

<tr>
<td>
Piston Extension (#34)
</td>
<td>
<center>True piston head</center>
</td>
<td>
<center>Block with texture</center>
</td>
<td>
<center>True piston head</center>
</td>
<td>
Detailed piston heads not fattened for 3D printing, may break. The <a href="https://www.reddit.com/r/Minecraft/comments/6akuvr/what_is_a_short_piston/">"short" property for pistons</a> is ignored, the model is always exported full length.
</td>
</tr>

<tr>
<td>
Slabs (#44, #126)
</td>
<td>
<center>True slab</center>
</td>
<td>
<center>Full block</center>
</td>
<td>
<center>True slab</center>
</td>
<td>
</td>
</tr>

<tr>
<td>
Torches (#50, #75, #76)
</td>
<td>
<center>Billboard torch (no flame)</center>
</td>
<td>
<center>Flattened</center>
</td>
<td>
<center>Flattened</center>
</td>
<td>
</td>
</tr>

<tr>
<td>
[Soul] Fire (#51)
</td>
<td>
<center>Billboards</center>
</td>
<td>
<center>Block with texture</center>
</td>
<td>
<center>Block with texture</center>
</td>
<td>
The bottommost texture copy found in Minecraft's fire_layer_0.png is used for this block. The various direction data values are ignored; the fire is always solid.
</td>
</tr>

<tr>
<td>
Stairs (#53, #67, #108, #109, #114, #128, #134, #135, #136, #163, #164)
</td>
<td>
<center>True stairs</center>
</td>
<td>
<center>Full block</center>
</td>
<td>
<center>True stairs</center>
</td>
<td>
Note that Minecraft 1.4 connects stairs differently. If you have a pre-1.4 world, use Mineways 2.22 to export it.
</td>
</tr>

<tr>
<td>
Chests (#54, #95, #146)
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Full block</center>
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
The chest textures in terrainExt.png are created by TileMaker using assets/minecraft/textures/entity/chest normal.png and normal_double.png.
</td>
</tr>

<tr>
<td>
Redstone Wire (#55)
</td>
<td>
<center>True geometry 1/4th pixel above surface - may cause z-fighting; use <a href="#composite">"Create composite" option</a> to flatten</center>
</td>
<td>
<center>Flattened</center>
</td>
<td>
<center>Flattened</center>
</td>
<td>
In Mineways wire is show either off or on, baked into the texture, with no gradations.
When "Split by block type" is used, the redstone wire is separated into up to 16 (identical - you may edit these) materials, "Redstone_Wire_power_15" down to "_power_0" to show how bright the wire should appear. For 1.16, the ability to turn an isolated dot into a cross is not supported in Mineways current.
</td>
</tr>

<tr>
<td>
Wheat Seeds (#59)<br>Sugar Cane (#83)<br>Nether Wart (#115)<br>Carrots (#141)<br>Potatoes (#142)<br>Beet Seeds (#207)
</td>
<td>
<center>Grows properly</center>
</td>
<td>
<center>Block with texture</center>
</td>
<td>
<center>Block with texture</center>
</td>
<td>
The fully matured texture is used for printing, on all sides.
</td>
</tr>

<tr>
<td>
Farmland (#60)
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Full block</center>
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
Wetness level is ignored.
</td>
</tr>

<tr>
<td>
Sign (#63)<br>
Wall Hanging Sign<br>
Hanging Sign<br>
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Removed</center>
</td>
<td>
<center>Proper geometry, with objects enlarged and chains removed</center>
</td>
<td>
Signs are cobbled together from block textures, not from assets/minecraft/textures/entity/signs. No lettering will appear.
</td>
</tr>

<tr>
<td>
Doors (#64, #71)
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Full textured block</center>
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
Door hinges and tops and bottoms on edges are not consistent with Minecraft.
</td>
</tr>

<tr>
<td>
Ladder (#65)<br>Lily Pad (#111)
</td>
<td>
<center>Proper geometry; <a href="#composite">"Create composite" option</a> shifts suspended lily pads to water level</center>
</td>
<td>
<center>Flattened</center>
</td>
<td>
<center>Flattened; suspended lily pads shifted to water level</center>
</td>
<td>
Orientation of lily pad is not available in basic data, so orientation is always the same.
</td>
</tr>

<tr>
<td>
Wall Sign (#68)<br>
Pressure Plates (#70, #72)<br>
Buttons (#77, #143)<br>
Snow (#78)
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Flattened</center>
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
Wall signs are put next to wall for printing - no gap. Signs are cobbled together from block textures, not from assets/minecraft/textures/entity/signs. No lettering will appear.
</td>
</tr>

<tr>
<td>
Lever (#69)
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Flattened</center>
</td>
<td>
<center>Flattened</center>
</td>
<td>
</td>
</tr>

<tr>
<td>
Cactus (#81)
</td>
<td>
<center>Interlocking billboards</center>
</td>
<td>
<center>Full block</center>
</td>
<td>
<center>Smaller block</center>
</td>
<td>
</td>
</tr>

<tr>
<td>
Fences (#85, #113)<br>Fence Gate (#81)<br>Cobblestone Wall (#139)
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Full wood block</center>
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
For 1.13 and newer versions, only "normal" wall types seen in game (without the debug stick) are supported, due to a limitation in the number of bits available in Mineways for data storage.
</td>
</tr>

<tr>
<td>
Portal (#90)
</td>
<td colspan="3">
<center>Proper geometry</center>
</td>
<td>
Uses the last texture copy in the Minecraft portal.png texture.
</td>
</tr>

<tr>
<td>
Cake (#92)
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Stretched to full block</center>
</td>
<td>
<center>Proper geometry</center>
</td>
Also see candle.
<td>
</td>
</tr>

<tr>
<td>
Redstone Repeaters (#93, #94) and Comparators (#149, #150)
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Flattened</center>
</td>
<td>
<center>Geometry without torches</center>
</td>
<td>
</td>
</tr>

<tr>
<td>
Trapdoor (#96)
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Flattened or block filled</center>
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
</td>
</tr>

<tr>
<td>
Iron Bars (#101)
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Textured block</center>
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
</td>
</tr>

<tr>
<td>
Glass Pane (#102)
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Replaced with Glass block</center>
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
</td>
</tr>

<tr>
<td>
Vines (#106)
</td>
<td>
<center>Geometry/flattened</center>
</td>
<td>
<center>Block geometry/flattened</center>
</td>
<td>
<center>Block geometry/flattened</center>
</td>
<td>
Since vines cannot hang in air for printing, blocks are added.
</td>
</tr>

<tr>
<td>
Enchanting Table (#116)
</td>
<td>
<center>Proper geometry, without book</center>
</td>
<td>
<center>Grown to block</center>
</td>
<td>
<center>Proper geometry, without book</center>
</td>
<td>
</td>
</tr>

<tr>
<td>
Brewing Stand (#117)
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Textured block</center>
</td>
<td>
<center>Textured block</center>
</td>
<td>
Delicate, and billboards won't print on a 3D printer.
</td>
</tr>

<tr>
<td>
Cauldron (#118)<br>Dragon Egg (#122)
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Stretch to full block</center>
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
When printed, area under cauldron is solid; top bit not added to completed portal frame.
</td>
</tr>

<tr>
<td>
End Portal (#119)<br>End Gateway (#209)
</td>
<td colspan="3">
<center>Full block only</center>
</td>
<td>
Uses the custom texture MW_END_PORTAL.png for the void
</td>
</tr>

<tr>
<td>
End Portal Frame (#120)
</td>
<td>
<center>Proper geometry, rotation is simplified to 90 degrees or not</center>
</td>
<td>
<center>Full block, no ender eye, correct rotation</center>
</td>
<td>
<center>Proper geometry, rotation is simplified to 90 degrees or not</center>
</td>
<td>
</td>
</tr>

<tr>
<td>
Cocoa Pod (#127)
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Removed</center>
</td>
<td>
<center>Pod geometry, no stem or gap</center>
</td>
<td>
Stem is removed for "lesser" printing.
</td>
</tr>

<tr>
<td>
Ender Chest (#130)
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Full block</center>
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
The ender chest textures in terrainExt.png are created by TileMaker using assets/minecraft/textures/entity/chest/ender.png.
</td>
</tr>

<tr>
<td>
Tripwire Hook (#131)
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Flattened</center>
</td>
<td>
<center>Flattened</center>
</td>
<td>
Note that tripwire itself is currently not added.
</td>
</tr>

<tr>
<td>
Tripwire (#132)
</td>
<td colspan="3">
<center>Removed</center>
</td>
<td>
Hey, it's supposed to be hidden...
</td>
</tr>

<tr>
<td>
Beacon (#138)
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Full block</center>
</td>
<td>
<center>Full block</center>
</td>
<td>
Faked by putting "beacon.png" texture at 11,14 in terrainExt.png.
</td>
</tr>

<tr>
<td>
Flower Pot (#140)
</td>
<td>
<center>Proper geometry made</center>
</td>
<td>
<center>Removed entirely, no decal</center>
</td>
<td>
<center>Pot geometry, and only cactus is made</center>
</td>
<td>
In Minecraft flower pot flowers are dimmer than the originals. Mineways does not dim these.
</td>
</tr>

<tr>
<td>
Head (#144)
</td>
<td>
<center>Half-wide pumpkin</center>
</td>
<td>
<center>Full-size pumpkin, rotated to nearest 90 degree angle</center>
</td>
<td>
<center>Half-wide pumpkin</center>
</td>
<td>
Mineways reads <a href="http://minecraft.wiki/w/Block_entity">block entity data</a> to get the rotation and type of head, but currently does not use the head type to put something other than a pumpkin. There is <a href="https://github.com/TheWeirdSquid/Minecraft-Player-Head-Tools">an add-on for Blender</a> that fixes this limitation.
</td>
</tr>

<tr>
<td>
Hopper (#154)
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Full block</center>
</td>
<td>
<center>Hopper interior filled in to make it solid</center>
</td>
<td>
</td>
</tr>

<tr>
<td>
Barrier (#166)
</td>
<td colspan="3">
<center>Normally hidden</center>
</td>
<td>
To make the barrier appear, create a color scheme and change the barrier's alpha to 255.
</td>
</tr>

<tr>
<td>
Standing Banners (#176)
</td>
<td>
<center>Reasonable geometry, no banner pattern</center>
</td>
<td>
<center>Removed</center>
</td>
<td>
<center>Removed, too thin</center>
</td>
<td>
Try <a href="https://www.jmc2obj.net/">jmc2obj</a>, which generates custom banner textures.
</td>
</tr>

<tr>
<td>
Wall Banners (#177)
</td>
<td>
<center>Reasonable geometry, no banner pattern</center>
</td>
<td>
<center>Removed</center>
</td>
<td>
<center>Made thicker, no banner pattern</center>
</td>
<td>
Try <a href="https://www.jmc2obj.net/">jmc2obj</a>, which generates custom banner textures.
</td>
</tr>

<tr>
<td>
End Rod (#198)
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Removed</center>
</td>
<td>
<center>Removed, too thin</center>
</td>
<td>
</td>
</tr>

<tr>
<td>
Chorus Plant (#198)
</td>
<td>
<center>Only one shape</center>
</td>
<td>
<center>Full block</center>
</td>
<td>
<center>Only one shape</center>
</td>
<td>
In the game itself the shape used varies based on location, in some unknown way.
</td>
</tr>

<tr>
<td>
Grass Path (#208)
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Full block</center>
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
Renamed to "Dirt Path" in MC 1.17, so Mineways 9.00 and newer versions use this name.
</td>
</tr>

<tr>
<td>
Structure Void (#217)
</td>
<td colspan="3">
<center>Normally hidden</center>
</td>
<td>
To make the tiny structure void block appear, create a color scheme and change the alpha to 255, and "Show all objects" (F7) to see it on the map. Structure void uses red wool for its tiny output block.
</td>
</tr>

<tr>
<td>
Observer (#218)
</td>
<td colspan="3">
<center>Unlit only</center>
</td>
<td>
The lit observer texture is found in terrainExt.png, but is not tested for and displayed.
</td>
</tr>

<tr>
<td>
Shulker Boxes (#219-234)
</td>
<td colspan="3">
<center>Side and bottom textures are derived from templates. Default shulker box colored purple instead of pale purple (doesn't use shulker_box.png).</center>
</td>
<td>
Shulker box sides and bottoms are created by using the color of the upper left pixel (2,2) of the top of the shulker box compared to the white shulker box top, multiplied by MW_SHULKER_SIDE and MW_SHULKER_BOTTOM.
</td>
</tr>

<tr>
<td>
Coral,
Coral Fan,
Coral Wall Fan
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Flattened</center>
</td>
<td>
<center>Flattened</center>
</td>
<td>
Flattened texture always applied to ground, even if wall fan.
</td>
</tr>


<tr>
<td>
Sea Pickle
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Flattened</center>
</td>
<td>
<center>Proper geometry, no tendrils</center>
</td>
<td>
Textures not applied exactly right. "Split by block type" will give <a href="https://minecraft.wiki/w/Light">separate emission levels</a> based on number of pickles.
</td>
</tr>

<tr>
<td>
Turtle Egg
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Flattened</center>
</td>
<td>
<center>Proper geometry, neighbor eggs touch</center>
</td>
<td>
1.14-style eggs; 1.13 mapped a 4x4 texture to a 3x3-size egg. Textures not applied exactly right.
</td>
</tr>

<tr>
<td>
Bamboo
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Grown to block</center>
</td>
<td>
<center>Grown to block</center>
</td>
<td>
Using the bamboo mosaic texture when 3D printing is a little odd, but better than nothing.
</td>
</tr>

<tr>
<td>
Stonecutter
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Grown to block</center>
</td>
<td>
<center>Proper geometry, without blade</center>
</td>
<td>
</td>
</tr>

<tr>
<td>
Lectern
</td>
<td>
<center>No book</center>
</td>
<td>
<center>Grown to block</center>
</td>
<td>
<center>No book</center>
</td>
<td>
</td>
</tr>

<tr>
<td>
Lantern
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Removed</center>
</td>
<td>
<center>Removed</center>
</td>
<td>
</td>
</tr>

<tr>
<td>
[Soul] Campfire
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Flattened</center>
</td>
<td>
<center>Flattened</center>
</td>
<td>
"Split by block type" will give <a href="https://minecraft.wiki/w/Light">separate emission levels</a> for when the campfire is lit or extinguished.
</td>
</tr>

<tr>
<td>
Scaffolding
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Full block</center>
</td>
<td>
<center>Full block</center>
</td>
<td>
Side texture for 3D printing is a little bit wrong, being thick on the top.
</td>
</tr>

<tr>
<td>
Respawn Anchor
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Full block</center>
</td>
<td>
<center>Full block</center>
</td>
<td>
"Split by block type" will give <a href="https://minecraft.wiki/w/Light">separate emission levels</a> for how many charges are left, 0-4.
</td>
</tr>

<tr>
<td>
Candles
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Removed</center>
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
No fire is exported on the wick for lit candles. "Split by block type" will give <a href="https://minecraft.wiki/w/Light">separate emission levels</a> based on number of lit candles.
</td>
</tr>

<tr>
<td>
Bamboo Fence and Bamboo Gate
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Full bamboo block</center>
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
Currently the bamboo_fence_particle.png and bamboo_fence_gate_particle.png textures are used for these, since the proper textures will take a lot of fussy texture mapping to use them properly.
</td>
</tr>

<tr>
<td>
Chiseled Bookshelf
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Full block</center>
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
The six separate books are not displayed individually. If there is any book in the bookshelf, it will be shown as fully occupied.
</td>
</tr>

<tr>
<td>
Decorated Pot
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
<center>Full block</center>
</td>
<td>
<center>Proper geometry</center>
</td>
<td>
Only the basic, uncracked pot is represented.
</td>
</tr>

<tr>
<td>
Pink Petals
</td>
<td>
<center>Billboards</center>
</td>
<td>
<center>Flattened</center>
</td>
<td>
<center>Flattened</center>
</td>
<td>
When 3D printing, only the full, "all petals" texture is applied to surfaces.
</td>
</tr>


<tr>
<td>
<a href="https://minecraft.wiki/w/Light_Block">Light</a>
</td>
<td colspan="3">
<center>Always hidden</center>
</td>
<td>
Meant for map makers
</td>
</tr>


</TABLE>

<HR>
<h2 id="versions">Version History</h2>
You can also see release notes at <a href="https://github.com/erich666/Mineways/releases">the Github repository</a>.
<P>
Find the latest Mac port on the <a href="downloads.html#mac">downloads/quick start page</a>.
<P>
The textures and rules used in Minecraft for how blocks appear and connect have changed over time, such as how stairs and chests are formed. If you want the closest fidelity, for a given version of Minecraft use the following version of Mineways. That said, older versions may have bugs fixed in newer versions. So, for texture consistency, you could also go the route of using the Minecraft textures of your world's version and make a special terrainExt file for Mineways, as explained on <a href="textures.html">the textures page</a>.
<UL>
<LI>Minecraft 1.20: Mineways version 11.00 or newer
<LI>Minecraft 1.19: Mineways version 10.00 or newer
<LI>Minecraft 1.18: Mineways version 9.08 or newer
<LI>Minecraft 1.17: Mineways version 9.00
<LI>Minecraft 1.16: Mineways version 8.08
<LI>Minecraft 1.15: Mineways version 7.12
<LI>Minecraft 1.14: Mineways version 7.07
<LI>Minecraft 1.13: Mineways version 6.08
<LI>Minecraft 1.12 and earlier: Mineways version 5.10
</UL>

<P>
From newest to oldest. The very newest is sometimes unreleased work in progress, with "*" meaning "to do" and "**" meaning "stretch goal."

<UL>

<LI>Version 11.06, 1/4/2024 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV1106.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
    <UL>
	<LI>Improve TileMaker, now at version 3.22, with the "-fnormal" option, which favors PNG normal files with a "*_normal.png" ending (which are found in Bedrock texture packs) over "*_n.png" normal files (found in Java). Normally (ha ha) you want to favor Java-Minecraft normals for Mineways if there's a choice. I added this option because I found a large number of "*_normal.png" (Java) files in JG-RTX had problems, such as normals being rotated 90 degrees. This option helps me work around the problem.
	<LI>TileMaker also now does a simpler check of each incoming normal texture. It now rederives the Z direction value from X and Y channels unless all incoming values are already normalized.
	<LI>The JG-RTX texture pack has been fixed with the proper normal maps, and the more interesting "medieval" textures are now used for glass. The file build_jgrtx_terrain_files.bat for building JG-RTX nicely (and showing various features of ChannelMixer and TileMaker) has been updated.
	</UL>
	
<LI>Version 11.05, 12/30/2023 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV1105.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
    <UL>
	<LI>Update to <a href="https://minecraft.wiki/w/Java_Edition_1.20.3#Blocks">1.20.3</a> (and 1.20.4), changing "grass" to "short grass" throughout and updating textures. The experimental 1.21 copper and tuff block types have not yet been added (that happens only on major releases).
	<LI>Fix Sketchfab uploads to properly show billboards with both faces.
	<LI>Convert unknown blocks to Bedrock by default, for all versions. These were being converted to Air. The block type can be changed using <a href="scripting.html#soc">"Set unknown block ID"</a> or <a href="scripting.html#soc">"Translate"</a> commands, as before. <I>(Thanks to abidcahngrembel for debugging help by sending a modded map and testing)</I>
	<LI>Fix map export to properly draw the correct layer. The old code did not properly add 64. <I>(Thanks to y.it for the bug report)</I>
	<LI>Add a comment line to the OBJ file when exporting individual blocks, so you can see what each block type is.
	<LI>Add random rotation for concrete powder and rooted dirt blocks.
	<LI>Allow barriers to be waterlogged (1.20.2 creative mode change).
	<LI>Add mirroring and 180-degree rotation as needed for Stone, Infested Stone, Bedrock, Deepslate, Infested Deepslate, and Skulk.
	<LI>Add random rotation for sides of blocks for Netherrack.
	<LI>Change random number generator so that Y (vertical) coordinate is also used to determine rotation and mirroring.
	<LI>Randomize lily orientation for rendering export (only; 3d printing composite textures would be messy).
	<LI>Remove Sculpteo from menus, as it no longer has much of a storefront for models.
	<LI>Other documentation cleanups and updates.
	<LI>ChannelMixer amd TileMaker updated to properly find barrier and decorated_pot_side textures, as well as the renamed short_grass.
	<LI>JG-RTX and Doku textures updated.
	</UL>

<LI>Version 11.04, 10/12/2023 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV1104.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
    <UL>
	<LI>Change USD export to a single directory, if desired: for "Export individual textures to", if the "tex" directory is set to blank instead of "tex", all output files are placed in the same directory as the main output file - no subdirectories are used. This can be a good thing for multiple exports, as only a single copy of the textures needed are output. <I>(Thanks to Alexander for the idea)</I>
	<LI>Add <a href="scripting.html#scriptOnlyTable">"Export using biome" script-only command</a>, which lets you select a specific biome when exporting. <I>(Thanks to Alexander for the idea)</I>
	<LI>Protect against crashing when elevation shading is on and the Height is set to -64. <I>(Thanks to TheChocolateOre for <a href="https://github.com/erich666/Mineways/issues/118">the bug report</a>)</I>
	<LI>Avoid crashing when switching lesser, detailed blocks off when exporting for rendering. <I>(Thanks to jae1911 for <a href="https://github.com/erich666/Mineways/issues/121">the bug report</a>)</I>
	<LI>Add one to the line number when reporting warnings in scripts.
	<LI>Change "Block moved by Piston" and "Tripwire" color to 0x010101 so that the Color Scheme option of "Hide All Blocks" works properly.
	<LI>Update <a href="#g3d">the free, custom G3D viewer for OBJ files</a> with a version that properly displays 2-color PNG files, such as those used in the Bare Bones texture pack.
	<LI>Other minor fixes (Export dialog shows proper state after bringing it up again after USD export with MDL off; change Netfabb pointers to free version).
	<LI>Note other resources on <a href="textures.html">the textures page</a> for shaderpacks, such as the <a href="https://wiki.shaderlabs.org/wiki/Shaderpacks">shaderLABS page</a>.
    <LI>Update JG-RTX terrain images.
	</UL>

<LI>Version 11.03, 9/8/2023 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV1103.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
    <UL>
	<LI>When <a href="scripting.html#soc">info/warning/error messages are suppressed</a>, they are now automatically sent to the scripting log file, if assigned. See the file hunk_output.mwscript for an example of how to use these commands.
	<LI>If nothing is exported, a warning instead of an error is issued. This means that a script exporting an empty selection will not abort. <I>(Thanks to TheChocolateOre for <a href="https://github.com/erich666/Mineways/issues/114">the suggestion</a>)</I>
	<LI>Show selection rectangle location and size in information bar (lower left). <I>(Thanks to TheChocolateOre for <a href="https://github.com/erich666/Mineways/issues/117">the suggestion</a>)</I>
	<LI>Modded block translation. The <a href="scripting.html#soc">"Translate:" command</a> lets you set a pick a modded block name and convert such blocks to a standard name when a world is read in. Block states (data values) can be used to some extent. See <a href="scripting.html#soc">the documentation</a> for details. Closes <a href="https://github.com/erich666/Mineways/issues/115">this issue</a>, for now.
	<LI>The script command "World:" etc. to load worlds now reloads the world if already loaded. This is important for "Translate:" to work pleasantly: you load a modded world, find some blocks need translation (by looking at the script log you've set), add those to your script, then run the script again, which reloads the world. See <b>mod_translation.mwscript</b>.
	<LI>More elaborate error message: display a list of modded blocks that were not found, instead of just the first block not found. Helps identify names of modded blocks for translation.
	<LI>Restructure USD output to be more in line with asset delivery, grouping everything into a single Xform.
	</UL>

<LI>Version 11.02, 8/30/2023 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV1102.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
    <UL>
	<LI>Remove mirroring (flipping) of bottoms of blocks. Once upon a time the bottom of Minecraft blocks were "flipped", being mirror images of the tops. Somewhere along the line this oddity was fixed, and in 1.20.1 the bottoms are no longer flipped. This release of Mineways takes out the flip, to match. If you want the flip back, use an older version of Mineways, as I do not want to track this behavior. The hardest part would be figuring out in what version this fix took place. <I>(Thanks to kazarmy for <a href="https://github.com/erich666/Mineways/issues/111">reporting this mismatch</a>)</I>
	<LI>Also fixed bark orientation on logs and bone blocks: no longer flipped, aligned same as in the game.
	<LI>Also fixed observers. Still more to fix, but it's fine.
	<LI>Sunflower backs are also not flipped now on export. The Doku textures have a problem here, that their sunflower backs are not mirror-image outlines of the fronts. This can lead to mismatches, so the Doku terrainExt files in this distribution have the sunflower backs flipped. Other Doku cleanups, and Tilemaker updated to version 3.20 and ChannelMixer to 1.15.
	<LI>New UI feature: hold down Shift while selecting a region and the selection will be square. Sorry, I don't display the size, though. <I>(Thanks to TheChocolateOre for <a href="https://github.com/erich666/Mineways/issues/112">the suggestion</a>)</I>
	<LI>Change USD shader normal3f and color3f inputs and outputs to float3, to more precisely match the specification. Delete unnecessary output and (mostly) alphabetize the parameter list, to fit with common practice.
	</UL>

<LI>Version 11.01, 8/18/2023 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV1101.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
    <UL>
	<LI>User feature request for USD export: if "Light scale" is set to zero, also don't export the camera (as well as not exporting the lights). <I>(Thanks to Alexander for the idea)</I>
	<LI>Adjust the application of the lectern top texture by one texel up, to properly match Minecraft.
	<LI>Read in piglin heads. I still don't convert these - they come out pumpkins - but at least they're properly read in and will show the correct name if the mouse is hovered over them. <I>(Thanks to Alexander for pointing out how <a href="#blocks">the Debug World</a> is now generated, which has the piglin heads)</I>
	<LI>Deal with "upper" pitcher plants of age 0-2, which are not possible in-game but show up in <a href="#blocks">the Debug World</a>. And deal with upper pitcher crops with an age less than 3, which are illegal but appear in the Debug World.	
	<LI>Added "inputs:" for USD variables, e.g., "float inputs:intensity" (was "float intensity"). Without the "inputs:" bit some USD readers would not read the intensity. Fixing this is a mixed blessing. Some programs that read USD assume high values (50k) for the Sun light, low values (like 1) for the Dome light. I have left the lights calibrated for reasonable viewing in NVIDIA's USD Composer and the upcoming Blender 4.0.0 version in development. See the <a href="usd_export_options">USD lighting options</a> for advice on setting these values for other renderers.
	<LI>Removed the transform for the Dome Light, due to <a href="https://github.com/usd-wg/assets/pull/44">this bug report and fix</a>. The original dome light worked in USD Composer, but that program has a bug. This means that, currently, this dome light incorrectly imports rotated 90 degrees along the X axis in USD Composer. See <a href="ovcreate">step 3a for USD Composer</a> for how to work around this bug.
	<LI>Changed some USD "float3" to "double3" to fit in with the norms. Changed tabs in USD output to spaces.
	<LI>Doku Light and Doku High texture packs updated to 1.20, and emission textures now included for each. Sphax is "contributor only" downloads currently. JG-RTX hasn't been updated for 3 months. Coterie Craft and Smoolistic look dead, so I may drop them someday.
    </UL>

<LI><B>Version 11.00</B>, 7/11/2023 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV1100.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
    <UL>
	<LI>Minecraft 1.20.1 support. New ChannelMixer version 1.14 and TileMaker 3.19. Added <a href="https://minecraft.wiki/w/Cherry_Grove">cherry grove biome</a>. 
	<LI>Fixed leave and vines in mangrove swamp biomes to use the proper, lighter green. Fixed deep dark biome downfall (rainfall) from 0.5 to 0.4. Wooded badlands biome now affects plant colors, same as other badlands. Values are from <a href="https://minecraft.wiki/w/Custom_biome">biome JSON files</a>.
	<LI>Made more cutout objects properly be one-sided when exported as such, such as sculk sensor tendrils.
	<LI>Fix mangrove door top and bottom to use mangrove plank texture for full block 3D printing.
	<LI>Fix Block Test World for newer fence and fence gate representations.
	<LI>A few fixes to "first face" flags for individual block export, so that individual blocks are always given names.
	<LI>Fixed mangrove roots so that they match between single and double sided output.
	<LI>Sculk catalyst and sculk sensor now emit light (barely).
	<LI>Update LunaHD pack. No other texture packs provided have updated to 1.20 at this point.
    </UL>

<P>
 <LI>Version 10.15, 5/9/2023 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV1015.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
    <BR>
    <UL>
	<LI>New export option: Billboard objects can now be exported as single-polygon or doubled-polygon for OBJ (USD has sidedness built in as an attribute). By default, just a single polygon is output per face, "Double all billboard faces" is unchecked. Most digital content creation apps I tested are fine with single polygons for cutouts such as saplings, flowers, etc. However, Unity (for one; there may be others) needs two polygons output back-to-back in order to display properly, as it (evidently) performs backface culling on these. Checking the box will double these. This option is available for all file formats except USD, which has its own flag for sidedness. (<i>Thanks to I C Y for this information.</i>)
	</UL>
	
 <LI>Version 10.14, 4/23/2023 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV1014.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
    <BR>
    <UL>
	<LI>Make all billboards (thin objects) export as only one quadrilateral, instead of two back-to-back quads. This avoids z-fighting seen in Blender 3.5's Cycles renderer. Looking at a range of other renderers, these all appear to now display billboards as two-sided, so only one quad is needed.
	<LI>Output USDA files in a format that shares vertices when possible (i.e., when not exporting individual blocks). This results in files that are about half the size of previous exports. When saved as USD (non-ASCII) format, the new USDs are less than a fourth of the size of the previous USD files. May also result in faster performance and less memory usage, depending on the renderer.
	<LI>Add extended naming for the Mesh instances in the BlockLibrary.usda when exporting individual blocks. (<i>Thanks to zNight for the suggestion.</i>)
	<LI>Added extents to all USDA meshes in the main output file. This information can help speed loading on some systems.
	<LI>Give a warning if the user types in a suffix for the export file and the file type selected does not match it.
	<LI>Better statistics summary, differentiating between full voxels and smaller ones, instead of calling all smaller ones "billboards".
	</UL>
	
 <LI>Version 10.13, 4/6/2023 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV1013.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
    <BR>
    <UL>
	<LI>Add status updates when exporting. Operations are now shown in the lower left corner of the application during large exports.
	<LI>Fix bug in USDA output where progress bar updates were being sent for every mesh. Small improvement in speed.
	<LI>With Blender 3.5 adding much-improved USD import and better OBJ import (and 3.6 looking better still, so far), I've updated <a href="mineways.html#blender">the Blender documentation for Mineways</a>.
	<LI>Scripting command names for some export options have changed in order to match the wording on the export dialog and documentation:
	<UL>
		<LI>"Export separate objects" is now "Export separate types"
		<LI>"Individual blocks" is now "Export individual blocks
		<LI>"G3D full material" is now "Custom material
		<LI>"Make tree leaves solid" is now "Tree leaves solid"
	</UL>
	Note that the old names will still read into this new version, i.e., it's backward compatible. The scripting documentation and render_defaults.mwscript have been updated accordingly.
	<LI>Updated USD output to new USD format that includes "prepend apiSchemas = ["MaterialBindingAPI"]" for each mesh. Why? I don't know.
	<LI>When all texture export is turned off, read just the header of the TerrainExt color terrain image and avoid all preprocessing for this file. (Sadly, the PBR textures still need to be read in, as we check whether various textures exist on output and adjust accordingly.) This change makes export for basic RGB a bit faster, especially when a large TerrainExt file is used.
	<LI>Added a small speed optimization to the simplify mesh system.
	<LI>Improved warning and error systems for when worlds do not load into Mineways <I>(Thanks, SeaJay, for noting the old message was confusing)</I>.
	<LI>Clarified the documentation for how to make custom terrain textures and for how to use the map annotation scripts.
	</UL>

 <LI>Version 10.12, 2/28/2023 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV1012.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
    <BR>
    <UL>
	<LI>Somewhere along the line exporting OBJ with no materials stopped working. Fixed <I>(Thanks, Biome, for the bug report)</I>.
	<LI>Stopped a few illegal combinations in the export dialog and updated the image in the documentation.
	<LI>During simplification, culled a few block material types a bit earlier in the process.
	</UL>

 <LI>Version 10.11, 2/26/2023 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV1011.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
    <BR>
    <UL>
	<LI>Improved block conversion so that "flat" lava and water can be affected by the Simplify Mesh option.
	<LI>I somehow deleted the name of the Export dialog - fixed.
	<LI>Improved Control-A, which selects everything on the screen, so that it also adjusts the height selected to what's visible.
	<LI>Cleaned up and expanded <a href="reference.html">the reference page</a> a bit.
	</UL>

  <LI>Version 10.10, 2/24/2023 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV1010.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
    <BR>
    <UL>
	<LI>New major feature: <a href="#simplify">mesh simplification</a>. It's a new checkbox on the export dialog. On a typical export (turning off borders), I have seen the polygon count drop by a half.
	<LI>Fixed wall connections, especially with iron bars and glass. See <a href="https://github.com/erich666/Mineways/issues/106">this issue</a> <I>(Thanks, CordylusLizard, for the bug report)</I>.
	<LI>Gray out the "Material per family" option when exporting individual textures, since it has no effect. Improve <a href="mineways.html#obj_export_options">corresponding documentation</a> <I>(Thanks, Photograph Otter, for the bug report)</I>.
	<LI>Grayed out the <a href="mineways.html#composite">"Create composite overlay faces"</a> checkbox when it cannot be changed (always in use for 3D printing,
	cannot be set when rendering and not using mosaics).
	<LI>Added to scripting the heightfield.py Python program, which reads an image and creates a heightfield.mwscript (example also included). See <a href="https://youtu.be/nqLYO4qofcM">this video</a> for the process.
	<LI>Improved register-Mineways-run-as-administrator.bat, which associates .mwscript files with Mineways. You're probably wiser to use the mineways.bat file for startup, but this bat at least highlights the .mwscripts with the Mineways icon.
	<LI>Updated the "Lower" slider message on first selection to be clearer and use "Depth" as the term.
	<LI>Vines and kelp plant textures should repeat on top and bottoms, not clamp. Fixed.
	<LI>Fixed a subtle bug where "Create block faces at the borders" was not working for the bottom faces at the minimum depth, if that minimum depth was less than 0 (as happens in the Block Test World).
    <LI>Update JG-RTX terrain images.
	</UL>
	
  <LI>Version 10.09, 2/8/2023 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV1009.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
    <BR>
    <UL>
	<LI>Deepslate blocks all were getting lumped into the "sapling" family. Now properly put in the "stone" family, which fixes their proper export with no "map_d" put in the material, and so properly import into Blender <I>(Thanks, DarkSheep / Olli, for the bug report)</I>.
	<LI>Tops of blackstone double slabs were getting the crimson slab texture <I>(Thanks, Refreshinq, for the bug report)</I>.
	<LI>My custom G3D fixed (highly recommended for OBJ viewing!) - it was missing a cubemaps subdirectory.
	<LI>USD PointInstancer mode has too many carriage returns when exporting.
	</UL>

  <LI>Version 10.08, 1/25/2023 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV1008.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
    <BR>
    <UL>
	<LI>IMPORTANT BUG FIX: Fixed lightning rod mapping and fixed mangrove wall signs. These bugs uncovered a more serious bug throughout Mineways, possibly affecting a whole bunch of blocks, now fixed <I>(Thanks, Refreshinq, for the bug reports)</I>.
	</UL>

  <LI>Version 10.07, 1/11/2023 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV1007.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
    <BR>
    <UL>
	<LI>Added tooltips and help button for the export dialog. Hover over a checkbox, etc., and get additional information. <I>(Thanks, StandingPadAnimations, for the suggestion)</I>
	<LI>Fix obscure export interaction and mode problems, such as exporting OBJ without materials then with materials giving assertions on swatches.
    <LI>Improve documentation a bit for the myriad export options, including <a href="#options">an old-school image map</a>.
	</UL>

  <LI>Version 10.06, 1/7/2023 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV1006.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
    <BR>
    <UL>
	<LI>Fixed <a href="https://github.com/erich666/Mineways/issues/102">stair neighbor export bug</a> for the old world format, 1.12 and earlier. <I>(Thanks, ouabout, for the test case)</I>
	<LI>Change default export for rendering for OBJ from 3 large images to individual textures. In polling users, seven out of eight wanted this change, and I agree. The large mosaic images are handy, but they do not work well with standard texture filter techniques such as mipmapping. Best to give the higher-quality export format by default. <I>(Thanks, StandingPadAnimations, for the suggestion)</I>
	<LI>Fix lantern chains, which had disappeared when I added propagule code - oops. <I>(Many thanks to Eearslya for <a href="https://github.com/erich666/Mineways/pull/103">their pull request</a> for this fix.)</I>
	<LI>USD improvements: better camera (proper Euler angles) and output first, enable indirect diffuse for the Omniverse real-time renderer.
	<LI>Change ice to have a roughness of 0.2 instead of 0.5, making it a bit more reflective.
	<LI>Better ChannelMixer 1.13 and TileMaker 3.18 warnings. Now "-u" (or "-v") on the command line for either will show any image files that are not used, instead of the previous behavior: showing all unused files (of any sort) by default. Verbose "-v" will also show, at the end, all block textures that were <I>not</I> found in the resource pack (i.e., not replaced) but are used in Minecraft, which can be a help. This is like the "-m" option in TileMaker. <I>(Thanks, Jaime Hedrera, for the suggestion)</I>
	<LI>Give <a href="mineways.html#mcpe">a full explanation</a> of the steps for using Amulet for Bedrock conversions, describing options and pitfalls.
    </UL>

  <LI>Version 10.05, 12/1/2022 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV1005.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
    <BR>
    <UL>
	<LI>Clean up export dependencies: "Split by Block Type" should be the default for rendering when toggling between it and "Export individual blocks" (docs also fixed), and "Custom material" should be grayed out (indeterminate) when "Export MDL" is off.
	<LI>Add scripting-only command: "Set unknown block ID", so that unknown blocks can be turned into something other than air. See <a href="scripting.html#soc">Script-only Commands</a> for more information. <I>(Thanks, zNight)</I>
	<LI>For USD, use the file name for the defaultPrim/Xform name. This makes tiled export of a world work better with Unreal. <I>(Thanks, David)</I>
	<LI>Fix block size scaling for USD, so that "Make each block" properly scales the USD output. Change the Model Export Dialog label to "Model size and 3D printing options."
	<LI>Fix the USDA camera generated for a single block.
    </UL>

  <LI>Version 10.04, 11/28/2022 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV1004.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
    <BR>
    <UL>
	<LI>Fix roughness value output when no roughness texture is available.
	<LI>Fix emissive surfaces (again!) for USDA MDL output. These were too bright, but the effect was hidden by the Omniverse firefly filter.
    </UL>

  <LI>Version 10.03, 11/21/2022 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV1003.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
    <BR>
    <UL>
	<LI>Rework USD export, to match behavior of latest Omniverse USD Composer, version 2022.3.0. Added camera and let default exposure take effect, modified all emitters to new light behavior, other little cleanups.
    <LI>Update the lodepng files, just in case this cleans up anything.
    <LI>TileMaker 3.17: If normals listed as 255,255,255, convert to 128,128,255 (happens with Smoolistic). Helps avoid any interpolation errors along the edges.
    <LI>ChannelMixer 1.12: Add a little more verbose info.</LI>
    <LI>Update JG-RTX terrain and LunaHD images, re-convert Smoolistic. Lava_still's emissions fixed.
    </UL>

<LI>Version 10.02, 9/17/2022 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV1002.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
  <UL>
  <LI>Add <a href="scripting.html#clo">"-suppress" command line option</a>, which suppresses all popup messages, allowing a near-batch mode for Mineways, with no pauses. 
  <LI>Add "Zoom out further" option under the View menu. Turns on <a href="scripting.html#clo">the experimental "-zl" command line option</a> and lets you zoom out to more than one block per pixel. Doing so may cause slowdowns or lockups. This is not a feature that is controllable by scripting (though can be invoked by the -zl command line option on startup). See <a href="scripting.html#clo">the scripting command line options</a> for more information.
  <LI>Bug fix: If the "Export individual textures to" directory ("tex" by default) is left blank, all textures are not placed in a subdirectory. For OBJ this means all the textures are in the same directory as the OBJ and MTL files (which worked fine). For USD the textures are now placed (and properly reference) in the "yourfilename_materials" directory instead of "yourfilename_materials/tex".
  <LI>Add defaultPrim to the USDA export for Mineways, to comply with the USD standard.
  <LI>Delete lens flare renderSettings. Fog settings will still be output if the Elevation shading option is checked. I still use ambientLightIntensity = 0.01.
  <LI>Improve "cannot read world" error message, noting that the world could be a Bedrock world.
	<LI>Fix: allow light values to be zero for USD export. Bug fix: a zero value for the "Light scale" value now properly means the external lights (sun and environment) are not exported at all.
  <LI>TileMaker option "-dcn", version now 3.16: when creating normal map terrain images, now check that the Z value isn't < 128 (force to 128 if it is) or <a href="https://wiki.shaderlabs.org/wiki/LabPBR_Material_Standard">always 255</a> (derive it from X and Y if so), and renormalize the normal to be close to 1.0 if it's far off in length, or has a Z value that goes from 0 to 1 (USD expects -1 to 1). If you don't want cleanup to occur, set "-dcn". Also, fix TileMaker miscount on deleting duplicate heightmaps.
  <LI>ChannelMixer version now 1.11: clean up typo in warning message about duplicate file found.
  <LI>Update documentation: update Houdini how-to, and mention <a href="https://github.com/erich666/McUsd">my McUsd test scene project</a>.
  <LI>Update JG-RTX terrain images.
  </UL>
  
<LI>Version 10.01, 6/14/2022 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV1001.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
  <UL>
  <LI>Fixed mapping of billboarded parts of mangrove propagule, properly mirroring the billboards.
	<LI>Fixed redstone dust wire getting trimmed vertically between blocks by the following blocks: beacon, ice, frosted ice, observer, and leaves. <I>(Thanks T2 Studios)</I>
	<LI>Update JG-RTX terrain images, including more mangrove textures.
  </UL>

<LI><B>Version 10.00</B>, 6/8/2022 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV1000.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
  <UL>
	<LI>Add Minecraft 1.19 blocks and biomes. 37 new blocks and 2 new biomes added. <B>WARNING</B>: fully mature cocoa pods have changed in 1.19 - different texturing coordinates are used. So, if you are using TileMaker, be sure your cocoa_stage2.png texture is in the proper 1.19 format, or just remove the texture so that the new default 1.19 texture is used. If you don't, there will be gaps in your mature cocoa beans, and no one wants that now, do they?
	<LI>Improve USD render settings, removing presets on path tracing (let the renderer decide what's best) and improving lens flare, etc.
	<LI>Update naming of standing signs, oak sapling, monster spawner. Fixed some wall names.
	<LI>Fixed some blocks that were not marked as connecting to neighbors.
	<LI>Updated ChannelMixer to 1.10 and TileMaker to 3.15.
	<LI>Updated all included resource pack files. Note that only JG-RTX has been updated at this point to include some 1.19 content. 
  </UL>

<P>
<LI>Version 9.16, 5/23/2022 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV916.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
  <UL>
	<LI>For some "optimized" chunks made by the <a href="https://www.curseforge.com/minecraft/mc-mods/lithium">Lithium</a> mod, Mineways runs out of memory when inflating. Increased CHUNK_INFLATE_MAX from 2 MB to 20 MB to fix it.
	<LI>Some optimized chunks use an integer for the "Y" level value instead of a signed byte. Interpret this non-standard field correctly.
	<LI>In the NBT error message, give the chunk location of the last chunk that was read that threw an error.
	<LI>When processing a script that makes a selection, but no world is open, give a better error message.
	<LI>Add comments to explain simple_export.mwscript more fully.
  </UL>

<LI>Version 9.15, 4/25/2022 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV915.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
  <UL>
	<LI>Break out of infinite loop when a corrupt level.dat was read <I>(thanks to 64stakLOL for reporting it)</I>.
	<LI>Fix naming glitch in ChannelMixer and TileMaker for PBR resource packs, where "piston_top_normal" was misidentified as a duplicate of "piston_top" instead of being a normal map. ChannelMixer is now at version 1.09, TileMaker at version 3.14.
	<LI>Move code base to Visual Studio 2022; fix some minor code problems it turned up.
	<LI>Update JG-RTX terrain images, including new corals.
  </UL>

<LI>Version 9.14, 4/2/2022 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV914.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
  <UL>
	<LI>Always turn off redstone face duplication, since we really can't see the side facing the block. Fixes <a href="https://github.com/erich666/Mineways/issues/93">issue 93</a> <I>(thanks to Lê Duy Quang for reporting it).</I>
	<LI>Fully support huge mushroom configurations, all 64 possibilities, instead of forcing these into the 16 configurations allowed by 1.12 and earlier <I>(thanks to MassiveSpeck for reporting it).</I>
	<LI>Recognize JG-RTX's non-standard "seagrass_doubletall_*" naming of "tall_seagrass_*" textures. ChannelMixer is now at version 1.08, TileMaker at version 3.13.
	<LI>Update C4D documentation, with a stress on using USD instead of OBJ. Update Blender documentation for "nearest".
	<LI>Explain limitations to block conversion a bit better and point people to <a href="https://www.jmc2obj.net/">jmc2obj</a> as an option.
	<LI>Update JG-RTX terrain images, including sea grass.
  </UL>

<LI>Version 9.13, 3/1/2022 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV913.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
  <UL>
	<LI>Fix problem with Amulet conversion of 1.18 world. Such Amulet chunks incorrectly have "Level" elements in them (<I>thanks <a href="https://www.youtube.com/channel/UCSuHYXysjzA_I43FUBDqUNQ?app=desktop">Watson</a></I>).
	<LI>Improve world read error message a bit, providing a code line number where the failure happened.
	<LI>Update JG-RTX terrain images: corals & cocoa beans.
  </UL>

<LI>Version 9.12, 2/11/2022 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV912.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
  <UL>
	<LI>Fix Mineways crash when 1.18 chunk is filled to near the top. This condition caused writing to unallocated memory (<I>thanks Aryan Banker for reporting this and providing the world</I>).
	<LI>Update JG-RTX terrain images.
  </UL>

<LI>Version 9.11, 1/30/2022 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV911.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
  <UL>
	<LI>Fix script logging assertion and error logging system problems (<I>thanks <a href="https://www.youtube.com/watch?v=3qRkvaL_Mo4">3411 Heaven Media</a></I>).
	<LI>Added <a href="scripting.html#soc">scripting (only) commands</a>: Show informational, Show warning, Show error. You can now suppress these three types of popups, both for running scripts and running manually. Be careful!
	<LI>Make all pop-up dialogs appear atop other windows; generally clean up various pop-up dialogs.
	<LI>Make extremely deep worlds (lower than -999 depth) display correctly and not crash.
	<LI>Update JG-RTX, Coterie Craft, Doku Light, Sphax, and LunaHD terrain images.
  </UL>

<LI>Version 9.10, 1/25/2022 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV910.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
  <UL>
	<LI>Support <a href="https://www.curseforge.com/minecraft/customization/deeper-world-and-expanded-build-height">the "Deeper World And Expanded Build Height" data pack</a>, which allows 1.17 worlds with heights -128 to 511. This is a partial fix for <a href="https://github.com/erich666/Mineways/issues/88">issue #88</a>, data packs in general. Now when a world is first opened, Mineways looks at the minimum height of the spawn location's and the player location's chunks. If this is -128, the maximum height is set to 511 (if not found to be this high already).
	<LI>More helpful error message when a new .schem file is encountered (basically says "read the .schem into a world, then use Mineways on the world").
	<LI>Update JG-RTX terrain images.
  </UL>

<LI>Version 9.09, 1/7/2022 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV909.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
  <UL>
	<LI>Properly read and ignore extra "__version__" data in Properties from Amulet-converted worlds - don't crash.
	<LI>Identify in the error message the first unknown block encountered, as a hint to the user (and me).
	<LI>Read biomes for 1.18 worlds. As biomes are 3D in 1.18, the biome at level 240 is used for display. This height is "above it all" most of the time, so can give the "from above" biome view, while also avoiding any conversion to 1.18 height problems.
	<LI>One level of selection undo. If you want to restore the previous selection (e.g., you goofed and accidentally deleted it or messed up a resize), hit Control-Z or select "Undo selection" from the View menu. This feature will not undo height slider changes but undoes just about everything other selection modification <i>(thanks, 4NIZIO)</i>.
	<LI>Added "blender_alpha_hashed.txt" script to set Alpha Hashed for all materials in Blender and updated <a href="#blender_blocky">the Blender documentation for step #9</a> <i>(thanks, Ohanno_Forgotten-Knight)</i>.
	<LI>Enabled fractional cutout opacity for the Omniverse USD Composer's RTX Real-Time renderer, so that semi-transparent objects look reasonable by default. Explained how to turn this option off for faster preview rendering. Here I would rather favor quality over speed by default, as otherwise it looks like a bug.
	<LI>In TileMaker, if the user specifies a tile size, abort if this is not a power of two.
	<LI>Updated JG-RTX terrain images.
  </UL>

<LI>Version 9.08, 12/10/2021 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV908.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
  <UL>
	<LI>Minecraft 1.18 support. This new version of Mineways will read in older worlds, but uses the latest naming for biomes. That said, biome reading is not yet implemented (it's complicated...).
	<LI>Fixed bug: if a 16x16x16 chunk slide is all one block type, it was getting turned into air.
	<LI>USD: Added MDL opacity_threshold export for cutout surfaces.
	<LI>Other USD export cleanups: floats to doubles for renderSettings, start at "./" directory for textures.
	<LI>Updated some texture files: CoterieCraft, Doku Light, JG-RTX.
	<LI>Added "blender_blocky.txt" script to make textures look blocky in Blender and updated <a href="#blender_blocky">the Blender documentation for step #9</a> <i>(thanks, 4NIZIO)</i>.
  </UL>

<LI>Version 9.07, 11/26/2021 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV907.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
  <UL>
	<LI>D'oh! For certain worlds, the new caching scheme (which now caches empty chunks, too) can cause a crash! I think I've plugged all the holes with this new version.
	<LI>Added <a href="#mcpe">instructions</a> for how to convert Bedrock to Java worlds using the free Amulet program.
  </UL>

<LI>Version 9.06, 11/24/2021 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV906.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
  <UL>
	<LI>Improved map chunk caching, giving smoother pans and faster response. Empty chunks now noted and cached; a resized cache doesn't empty it; other improvements and cleanups. You might still run out of memory - don't make the screen so large.
	<LI>Experimental feature: <a href="scripting.html#clo">zoom out further</a> (-zl # on command line). Setting this (even if you don't zoom out) will also have an effect on initial cache memory allocated for mapping. See <a href="scripting.html#clo">the description</a> - YMMV.
	<LI>Zoom level now shown in the title bar if it's not exactly 1.0. Absolute chunk numbers are now shown at the end of the information display in the lower left (if nothing else, it helps me debug).
	<LI>TileMaker version 3.11: if terrainBase.png is not found in current run directory, uses ..\terrainExt.png for this file. This means less messing about for the beginning user (no need to copy ..\terrainExt.png to terrainBase.png).
	<LI>Fixed Sketchfab upload to work when user names use wide characters; <a href="https://github.com/erich666/Mineways/issues/90">issue #90</a> <I>(thanks, Tarcadia!)</I>.
	<LI>Roughness and metalness improved for the various copper block types.
	<LI>Fixed jack o' lantern emitter to emit only from holes in pumpkin (you want different, put emission textures into place for the sides and top).
	<LI>USDA: Added Light scale for scaling the sun and dome light. Default value is 30. Setting this value to 0 turns off light export entirely.
	<LI>USDA: Scaled the emissive texture up properly (by about 1000) for the UsdPreviewSurface representation, and exposed this in the export dialog as Surface emit scale. Emission from surfaces is not well-defined for UsdPreviewSurface, so you may need to fiddle with this scale factor depending on your application and needs.
	<LI>USDA: Added "Export MDL" checkbox, on by default. If you know you don't need MDL material descriptions, turn this off; only the UsdPreviewSurface material representation will be exported.
	<LI>Emission textures: these are now exported as colored textures. They are generated by multiplying the chroma of the diffuse texture (i.e., the "maximum" color for the pixel) by the emission grayscale texture, if any. This is generally a better look for blocks such as lava than the grayscale emissive texture, which various DCC apps interpret in different ways.
	<LI>USDA: Better default sun and dome light Euler angle ordering. X rotation is now altitude, Y is azimuth, Z does nothing. Change fog to be mild, not pure gloom.
	<LI>USDA (only): For roughness and metalness and emission textures, test if all values in the texture are the same value. If so, export the value instead of exporting the texture.
	<LI><a href="#usd_export_options">USD documentation</a> added.
	<LI>Updated JG-RTX terrain files.
  </UL>

<LI>Version 9.05, 11/2/2021 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV905.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
  <UL>
	<LI>USDA: Export the backfaces of sunflowers.
	<LI>USDA: Export all cutouts and semitransparent textured objects as "doubleSided".
	<LI>Fix off-by-one error for world list, where the last world was listed but unselectable.
  </UL>


<LI>Version 9.04, 10/26/2021 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV904.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
  <UL>
	<LI>Major change: export the OBJ material attribute "map_d", so that textures will import with cutouts automatically. This helps Blender and Cinema 4D, among others. The custom <a href="#g3d">G3D viewer</a> has also been updated (and has a new name "viewer.exe" instead of "viewer64.exe"), fixing a bug it had with using a separate map_d when individual textures were exported from Mineways (it would extract the red channel instead of the alpha channel from the RGBA texture).
	<LI>Power user feature: drag and drop a model file (*.OBJ, *.USDA, *.WRL, or for STL, the related *.TXT file) on to Mineways and you will go to the settings used for that model (similar to Import Settings). Same with *.MWSCRIPT <a href="scripting.html">scripting</a> files. Drop a terrainExt*.png and it will set this terrain file. Drop a .dat world file and it will open this world. Drop a .schematic file and it will open that model.
	<LI>OBJ: make "split by block type" the new default setting for OBJ export, to help improve assigned roughness (specular power) for all materials. Really, this option should probably go away at this point, as "block families" are not easily determined, since type numbers are no longer used.
	<LI>Tiny adjustment to sunflower back and front, so these no longer z-fight.
	<LI>OBJ and USD: fix and adjust the default roughness (and metalness, if used) for many materials to be more reasonable, basing off the created material name.
	<LI>USD: do not set sRGB for the emitter color space for UsdPreviewSurface.
	<LI>USD: a few materials were not properly marked as semitransparent. Ice and frosted ice, nether portal, and honey fixed.
	<LI>Sketchfab and USD: Check if glass and a few other textures are cutouts or semitransparent when they're output, so that map_d can be set if needed for Sketchfab and the opacityThreshold can be set appropriately for USD. Since its status can be determined, glass is now a cutout by default (as it is in original Minecraft).
	<LI>Do not allow the "individual textures" directory to be a path, only allow a simple folder name.
	<LI>Better error reporting for TileMaker (now version 3.10) when terrainBase.png is not in the current directory. (<I>Thanks to Common for reporting the weak error reporting.</I>)
	<LI>Make copper ore and deepslate copper ore more noticeably different than stone and deepslate on the map. (<I>Thanks to <a href="https://www.reddit.com/r/mineways/comments/q7jsoq/copper_and_deepslate_copper_ores_have_no_color_to/">MadeInSteak</a> for the suggestion.</I>)
	<LI>Rename "Export full color texture patterns" to "Export all textures to three images", to better describe it. Similarly, "Export separate textures" is now "Export individual textures", and "Export richer color textures" to "Export noise textures with color." Documentation, export code, and scripting updated.
	<LI>Change export directory name for individual blocks to "tex".
	<LI>Update documentation for Blender and C4D, now that map_d is exported properly.
	<LI>Remove ancient BlenderScripts directory - use MCprep instead.
	<LI>Updated JG-RTX terrain files with the very latest (they're constantly being updated). Notes: removed lava_flow_e.png as it's dim.
  </UL>


<LI>Version 9.03, 10/10/2021 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV903.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
  <UL>
	<LI>Fixed crash condition when "Delete floating objects" is checked for rendering export. Blocks along the "air block"
	buffer around the edges of the volume were being misidentified as containing something. Fixed because <a href="https://youtu.be/PpuhWRfhH_E">this video</a> recommended checking "Delete floating objects."
	<LI>Updated JG-RTX terrain files with the very latest (they're constantly being updated).
  </UL>

<LI>Version 9.02, 10/1/2021 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV902.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
  <UL>
	<LI>Fixed dumb regression bug (as opposed to my usually highly intelligent bugs) turning glass and water opaque for USD export.
	<LI>Fix zipping up files to be more robust, properly grabbing all files and deleting subdirectories for USD if files themselves are not to be saved.
	<LI>Updated TileMaker to properly identify grayscale heightmaps, version 3.09.
	<LI>Updated JG-RTX terrain files with the very latest (they're constantly being updated).
  </UL>

<LI>Version 9.01, 9/24/2021 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV901.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
  <UL>
	<LI><I>Update</I>: 9/29/2021 updated TileMaker to properly identify grayscale heightmaps, version 3.09. No new release; simply updated in the 9.01 zip file.
	<LI>Important bug fix: properly interpret flowing_water, flowing_lava, empty, and ominous_banner - not sure that last one is needed (<I>thanks to theOther_Kloud for reporting this problem</I>).
	<LI>Memory leak fixes: "empty" (no Sections) chunks were not cached, and clearing the cache during export did not properly free the new block structures.
	<LI>Read 1.18 beta worlds, as the data format has changed.
	<LI>Added ability to remap the left, middle, and right mouse buttons' functionality: use "Set mouse order" using <a href="scripting.html#soc">scripting</a>. The new remap_mouse_buttons.mwscript gives a fuller description.
	<LI>New command: View->Information (shortcut key: i). Shows major version of the world and other bits of information. The major version is also now shown at the top in the title.
	<LI>Make hotkeys work even if caps lock is on.
	<LI>When exporting using the biome, show in the statistics popup which biome was chosen, and note the same at the top of the OBJ, VRML, or USD file.
	<LI>Shrink grass by 15/16ths, and put it from 0.0 to 3.0 texels down (<I>thanks to Raihan for reporting this problem</I>).
	<LI>Since glass now has a tinted type, when filling areas with glass for 3D print export, set the data value properly to 0 to avoid problems.
	<LI>Improve USD opacityThreshold settings for cutouts, now that Houdini has fixed its renderer.
	<LI>Output lights first for USD export. This makes them easier to find and modify.
	<LI>Fix zip export for USD files, and allow single-texture 3D print output for 3D printed USD.
	<LI>Fixed azaleas in pots to display properly and have the right material name.
	<LI>Fix incorrect identification of double-height flowers when the top is cut off by the height slider.
	<LI>Better labels for various file selection dialogs; tiny spacing cleanups on export dialog box.
	<LI>Internal cleanups, handling empty chunks more carefully and cleanly.
	<LI>Show different colors for azalea, flowering or not.
	<LI>Note in the Color Scheme editor that entries 396 and 400 are unused.
	<LI>Version 1.07 of ChannelMixer and 3.06 of TileMaker: Interpret fletcher_table_side1 as fletching_table_front, fletcher_table_side2 as fletching_table_side.
	<LI>Texture packs updated to JG-RTX 0.19.1 and BD Craft 1.17. Sadly, Coterie and Doku look to be abandoned, with no 1.17 content, so may be dropped in the future.
	<LI>Fix documentation for 3D printing instructions about filling in doors and windows (<I>thanks to Cadage for asking about this feature</I>). Other minor documentation improvements.
  </UL>

<LI><B>Version 9.00</B>, 7/3/2021 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV900.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
  <BR>
  <UL>
	<LI>Minecraft 1.17 support. This version of Mineways will read in older worlds, but uses the latest naming conventions, e.g., "Dirt Path" instead of "Grass Path," "Block of Lapis Lazuli" instead of "Lapiz Lazuli Block." Lectern top <a href="https://bugs.mojang.com/browse/MC-214568">is lowered for 1.17</a>. New textures used, of course.
	<LI>Chunk maximum "filled" height is now tracked on load. This speeds up model export, as well as providing faster map updates when the display mode is changed.
	<LI>The "Give more export memory!" feature has been further enhanced. When turned on, chunks that are loaded are reduced in storage size, eliminating the blank air storage at the top of each. This storage reduction can result in considerably slower map load times (about 3 times as long). But, overall memory use dropped from 2.8 GB to 1.8 GB for a giant full-screen view of a world.
	<LI>The increase in height for the 1.17 betas from 21w06a to 21w14a is supported, but back to normal height for 21w15a on.
	<LI>Fix tall seagrass so that it extends one pixel higher (<I>thanks to Raihan for reporting this problem</I>).
	<LI>Have TileMaker (v.3.05) not flag any tiles manufactured internally by Mineways as missing.
	<LI>Fixed bug in TileMaker where if a _normal and _heightmap PNG both existed, no warning was produced and the heightmap was not properly ignored.
	<LI>ChannelMixer (v.1.06) now quietly ignores files that are not used by Mineways, e.g., debug.png, instead of reporting them as unused. This should make it easier to identify which textures are in a resource pack that have non-standard naming.
	<LI>UsdPreviewSurface had "asset inputs:wrapS", fixed to "token inputs:wrapS".
	<LI>UsdPreviewSurface now negates the inputs:scale and inputs:bias values to be -2.0f and 1.0f, respectively, to get normal mapping to work properly.
	<LI>Fix "Glass" to be transparent and not a cutout.
	<LI>Change "Export tiles to textures" to "Export separate textures", which I think is clearer.
	<LI>Tiny space optimization: cut back on the "standard" set of normals output, as possible.
	<LI>Other little fixes to names for blocks, cleanups for 3D colored prints, etc.
	<LI>Remove terrainExt_ModernHD.png terrain, as <a href="https://resourcepack.net/modern-hd-resource-pack/">this pack</a> has not been updated since 1.13. Updated Coterie Craft to 1.16, but at 16x resolution, down from 32x.
  </UL>

<P>
<LI>Version 8.08, 6/17/2021 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV808.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
  <LI>Re-fix the biome system - I fixed a biome bug in 8.06, but then left in some debug code that forced everything to be a swamp. D'oh. Thanks to Evgenii for reporting this major bug.</LI>
  <LI>Add "Focus View" option, under the View menu. Lets you center the view at a given location.
  <LI>Fix <a href="https://github.com/erich666/Mineways/issues/82">issue #82</a>, add base color to banners exported from worlds from Minecraft 1.12 and earlier.</LI>
  <LI>Change doors to all possibly have cutouts. While vanilla Minecraft doors do not, some resource packs add cutouts. Really, I should test all textures for alpha cutouts, but that can be costly and it's simpler to just note doors can have semi-transparency.
  <LI>Change UsdPreviewSurface to output the opacity threshold and use the diffuse texture alpha only if the texture has semitransparency or is a cutout.
</UL>


<LI>Version 8.07, 5/5/2021 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV807.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Fix obscure interaction between OBJ and USDA individual block export by making the two values entirely separate.
<LI>Clean up [Block Test World] map a bit, getting rid of duplicates such as Dead Bush (33:0 and 34:0) and Double Quartz Slab (43:7 and 43:15), adding types of Wood.
<LI>Unify UDSA export files: put all export files other than the primary USDA file in a subdirectory. This is much tidier, though it means the custom materials need to be recompiled for every model, not per directory, and the texture library directory doesn't get shared (for good or ill). Also removed unneeded parameters from the Minecraft.mdl file.
<LI>Fix USDA instancing: don't shift instances from origin, move all scaling to scale transformation, get rid of non-graphical data values (such as the age of the fire), check for piston as a full block, note double slabs are waterloggable but don't actually output water for their locations, and much other trivia too painful to describe.
<LI>Added a video for using Mineways with the free <a href="#houdini">Houdini Apprentice</a> program.
</UL>

<LI>Version 8.06, 4/14/2021 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV806.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>For USD export, allow export of individual blocks, created as instances. The "Export individual blocks" option creates separate block and material USD files. Not every block type will export nicely, due to limitations in Mineways' data structures, but it gets pretty close. The excitement here is that it means simulations or other manipulations are now possible for USD scenes.
<LI>Map grid, "m" hotkey: overlays a grid showing the Anvil (r*.mca) file bounds and the individual chunks. Also, map file and chunk numbers are now always shown in the status display in the lower left. One of those "I should have added this a decade ago" features, as it also helps me debug. (<I>thanks to <a href="https://www.reddit.com/r/mineways/comments/m5m7h4/export_complete_world/">lajawi</a> for the suggestion.</I>)
<LI>Note if block is waterlogged in status display (but only if it isn't always waterlogged, i.e., <a href="https://minecraft.wiki/w/Waterlogging">inherent</a>).
<LI>Add waterlogged status to some [Block Test World] blocks; also fix this world in a number of places.
<LI>Updated color schemes to include all block types, using my internal block type numbering scheme for blocks from 1.13 on. If you get flaky problems with old color schemes, at worst you can always run REGEDIT and delete the ColorSchemes directory at "Computer\HKEY_CURRENT_USER\Software\&lt;your name here&gt;\Mineways".
<LI>Fix walls: increase height by one, and become solid (and remove the post if not at a junction) if there is an object above the post. Note that the new 1.16 wall rules are not complete, but closer than they were. It will take major rework of the data values system (e.g., go to 16 bits) to capture the full state of a wall block. (<I>Thanks to Joefy200 for reporting this bug.</I>)
<LI>Fix fences: glass blocks now properly connect to fences. Also encoded fences, iron bars, clear glass pane, pumpkin and melon stems, and chorus plants to properly read in and use attributes stored in 1.13 and newer maps.
<LI>Fix biome coloration code: mesa and roofed forest colors fixed. (<I>Thanks to Joefy200 for reporting <a href="https://github.com/erich666/Mineways/issues/80">this bug</a>.</I>)
<LI>Kick the built-in Block Test World up two blocks in height, so that the visible y height is not negative.
<LI>Cleaned up VRML export, so that it properly shows in the export dialog using a single mosaic tile during export. Fixed VRML and STL export so that radio buttons that should not be selectable, aren't.
<LI>UsdPreview fixes for Houdini: opacityThreshold set to 0.001, set proper wrap mode for s and t texture wrapping.
<LI>Changed "map_metallic" to "map_Pm", proposed <a href="http://exocortex.com/blog/extending_wavefront_mtl_to_support_pbr">here</a> and noted <a href="https://en.wikipedia.org/wiki/Wavefront_.obj_file#Physically-based_Rendering">here</a>. Output both "norm" and "map_Kn" for normal maps and both "map_ns" and "map_Ns" for shininess maps when exporting PBR textures to OBJ materials, due to <a href="https://github.com/assimp/assimp/issues/3726">this issue</a>.
<LI>ChannelMixer/TileMaker: support TGA input. Improve logic for testing for cutouts, clean up error and warning messages.
<LI>For UsdPreview material, set wrapping vs. clamping of tiles, to avoid "fire wrap" problem (where the bottom of a fire gets interpolated to the top edge of the tile). I believe I made this fix in 8.05 but forgot to record it.
<LI>Fixed sapling name display, properly masking off the age_bit.
<LI>Added a "<a href="#nightmarelist">Nightmare List</a>"  to the docs, basically proposed features that seem like too much work for too little return.
</UL>

<LI>Version 8.05, 3/16/2021 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV805.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Fix a regression: waterlogged glass panes now properly connect with one another again. (<i>Thanks to Parkouristik93 for reporting this error.</i>)
<LI>Fix textures on waterlogged glass panes.
<LI>Fix waterlogged chain to be properly oriented.
<LI>Fix lanterns to be waterloggable.
</UL>

<LI>Version 8.04, 3/12/2021 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV804.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Better fix for Minecraft 1.17 beta export - now shows height properly. Note: due to the height increase, this version and future versions of Mineways will use about 50% more memory for all maps. If you find you get an out-of-memory error during export, selecting the "Give more export memory!" item in the Help menu before export will free up all cached offscreen chunks, at the expense of map update performance.
<LI>For OBJ export, a mild specular highlight (Ns) and relative Ks is now exported, if "Custom material" is chosen (which is now the default). This works nicely with G3D, which applies a reflectance map. If "Custom Material" is not selected, a minimal MTL is exported. See <a href="#full_material">Custom Material</a> for more information.
<LI>USDA Glass and water look better now, due to turning on the opacity texture for MDL and turning the opacityThreshold to 0 for UsdPreview. Also, the emission texture is now exported; previously, it was not, due to a misplaced line of code.
<LI>Improve export of grayscale textures from Mineways. Now there are better rules to decide if a tile is grayscale (and should be tinted by the color assigned to the block or by using the biome) or if it is already fully colored, as done by some resource pack creators.
<LI>Use "invisible" neighbors to affect the output. That is, given an export area, there are neighboring blocks that are not output but that can affect whether a fence is created, what the height of the water should be, etc. These invisible neighbors were used only when "Create block faces at the borders" was off, but they should be used all the time, so that water doesn't "droop" around the region edges. Note for making tiles you'll still probably want to turn off borders at edges.
<LI>Fix water height calculations to be affected by "invisible" neighbors.
<LI>Double-chests that are chopped in half now are "capped" vs. being incomplete, when "Create block faces at the borders" is on (latches are still exported for only the left side of a double chest). Note: this fix may affect other objects - let me know of any bugs.
<LI>TileMaker: Crazy involved code to examine the grass_side_overlay/grass_side/grass_side_carried textures and try to use the right ones.
<LI>ChannelMixer and TileMaker: Detect heightfields better, and support "_heightmap.png" extension directly.
<LI>Updated JG-RTX to <a href="https://github.com/jasonjgardner/jg-rtx/releases/tag/0.14.2-alpha">0.14.2-alpha</a>.
</UL>

<LI>Version 8.03, 2/15/2021 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV803.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI><B>Temporary patch</B> for 1.17 beta crash, <a href="https://github.com/erich666/Mineways/issues/75">issue #75</a>. For <a href="https://minecraft.wiki/w/Java_Edition_20w49a">snapshot 20w49a</a> and newer, 64 is added to the world's height, so that the now-deeper underworld is handled. This means Mineways Y coordinates for these worlds is displayed incorrectly, until I come up with a full patch. As important, "only" 256 levels, Y=-64 to Y=191, for beta worlds will be displayed. Anything higher is ignored.
<LI>Added "Transparent water" toggle to the View menu, hotkey "t". This removes water from the map view, only. Water blocks will still be exported normally. If you truly want to remove water from export, use a <a href="#schemes">color scheme</a> and set the alphas of water and stationary water, #8 and #9, to 0.
<LI>Properly set the stonecutter block with a flag noting it has cutout content, the saw.
<LI>Fixed output of normal map textures for the UsdPreview material, properly scaling and biasing them.
<LI>Added the ability to change the normal map strength for custom USDA materials. Lower resolution normal maps are often <a href="https://www.tandfonline.com/doi/abs/10.1080/2151237X.2005.10129203">formed poorly</a> by their creators, resulting in the bumps getting blended away. Increasing the strength, essentially the slope, of normal maps can help improve these a bit. This is also useful for heightfield textures, where a scale factor is not specified.
<LI>ChannelMixer now also detects BMP files and warns of them. ChannelMixer now warns of valid files found but ignored due to the "-k" flag being set, and gives a summary of the types of files found.
<LI>Updated JG-RTX to <a href="https://github.com/jasonjgardner/jg-rtx/releases/tag/0.12.0-alpha">0.12.0-alpha</a>, the rustic release.
</UL>

<LI>Version 8.02, 1/29/2021 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV802.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Display some statistics when done exporting for rendering. This has the bonus of making a "ding" sound when an export completes.
<LI>Added a <B>beta</B> of USDPreview materials, which means that programs that read USD files (such as the free <a href="https://www.sidefx.com/products/houdini-apprentice/">Houdini Apprentice</a>) can use Mineways USD export files. (<i>Thanks, Ben Skinner!</i>)
<LI>Added LunaHD sampler and Smoolistic PBR texture packs. See <a href="textures.html">previews</a>.
<LI>Somewhat better progress bar update when reading in large PBR terrain file sets.
<LI>Fixed stair orientation for stairs in version 1.13 on (<a href="https://github.com/erich666/Mineways/issues/68">issue #68</a>). (<i>Thanks to ChlorideCull for reporting it.</i>)
<LI>Fixed "Change blocks" scripting command bug (<a href="https://github.com/erich666/Mineways/issues/69">issue #69</a>). (<i>Thanks to ChlorideCull for reporting it and pointing to the code change that caused it.</i>)
<LI>Extended the "Change blocks" scripting command to partially support 1.13+ block names, and updated the <a href="scripting.html#cbce">scripting documentation</a>.
<LI>Make the array for swatch UVs larger, to avoid crashing when exporting large 3D prints.
<LI>ChannelMixer now attempts to test if texture files are in the newer <a href="https://github.com/rre36/lab-pbr/wiki/Specular-Texture-Details">LabPBR format</a> where the specular alpha channel holds emission data. ChannelMixer also now detects JPEG images that have not been converted to PNG and warns about them. Incremented to version 1.01.
<LI>TileMaker now checks if a block's tile is not properly square. Incremented to version 3.01.
<LI>The lodepng PNG reading package was updated to a new version (which has better memory handling and bug fixes) and regrooved for wide character filenames.
<LI>Internal: change mallocs to callocs for slightly better and more readable code.
</UL>

<LI>Version 8.01, 12/17/2020 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV801.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>A small flaw in one custom material file was causing Omniverse USD Composer's renderer to spend about 50% more time ray tracing than needed. Fixed.
<LI>Added "Choose Terrain File" selector to File menu. All color "terrainExt*.png" files found in the same directory as mineways.exe at startup are listed.
<LI>Added a low-res version of <a href="http://lunahd.com">LunaHD</a> as an optional terrain file set for rendering.
<LI>Added more menu items for specific help, and for <a href="textures.html#dl">the terrain file download area</a>.
<LI>Reorganized the terrain file documentation and generally cleaned up and updated it.
<LI>JG-RTX updated, and brick replaced with a less obvious repeat pattern.
<LI>8.01a release: to avoid release fatigue, I've taken the unusual step of making an "01a" release. Changes: terrain file directory detection fix, small updates to docs, use PNG image crush on JG RTX to reduce download size.
</UL>

<LI><B>Version 8.00</B>, 12/15/2020 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV800.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI><B>Support for USD into Omniverse USD Composer</B>. <a href="https://graphics.pixar.com/usd/docs/index.html">USD</a> is a new file format used by the film industry. <a href="https://www.nvidia.com/en-us/omniverse/apps/create/">Omniverse USD Composer</a> is a free product out in beta that lets you see your scene path-traced at interactive rates. See <a href="#ovcreate">this documentation</a> for how to use Create with Mineways.
<LI><B>Physically based material support.</B> USD supports exporting more elaborate material models. Mineways integrates with this, exporting USDA files and physically based textures from resource packs. To help the process of taking an arbitrary resource pack and converting it to the textures Mineways needs, a new easy-to-use (really!) command-line utility is available: <a href="textures.html">ChannelMixer</a>.
<LI><B>TileMaker regrooved</B>. TileMaker takes block face textures and makes "terrain files" that Mineways uses to texture models. This utility program has gone through an overhaul, now supporting making physically based terrain files for Mineways, for use by Omniverse USD Composer and possibly OBJ files. See the <a href="textures.html">new documentation page</a> for a tutorial and details.
<LI><B>JG RTX:</B> This <a href="https://github.com/jasonjgardner/jg-rtx">resource pack</a> is included with Mineways, in both 64x64 and 256x256 versions. That's why the download got so large... Download <a href="https://github.com/jasonjgardner/jg-rtx/releases">the original</a> for higher resolution versions of some textures.
<LI>Fix <a href="https://www.reddit.com/r/mineways/comments/k68ga4/720_horizontal_chains_appear_vertical/">chain export bug</a> by supporting horizontal chains. <I>(Thanks to Chris for reporting this bug.)</I>
<LI>The shortcut control-A now selects the entire visible screen when exporting from a world map. For schematics opened in Mineways, control-A continues to select the entire schematic, regardless of the visible screen.
<LI>For custom terrain files, don't multiply by the biome color if the texture itself is not grayscale. Applies to grasses, ferns, leaves, water, stems, vines, redstone wire, and lily pad.
<LI>Other small cleanups and better use of memory.
</UL>


<P>
<LI>Version 7.20, 11/30/2020 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV720.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>If a terrain file other than the default "TerrainExt.png" is selected, show that name in the title bar at the top.
<LI>Fix chest to use proper latch, not the Ender chest latch.
<LI>When a campfire was put on a hay bale to make a signal fire, Mineways would export a soul campfire - fixed.
<LI>Fix end portal so that it is the proper height and just a two-sided layer, not a full block.
<LI>Campfires were incorrectly lit, due to a flag not being cleared from button settings - fixed <i>(Thanks to Kyra007 for <a href="https://www.reddit.com/r/mineways/comments/jl60kt/extinguished_campfire_appears_as_lit/">reporting this bug</a>)</I>.
<LI>Blocks of redstone were incorrectly acting as emitters - fixed.
<LI>Nether portals for pre-1.13 worlds were not getting exported properly if they ran north-south.
<LI>Snow was getting converted to stone cutters when MCPE converted from Bedrock to Java and then Mineways read this faulty conversion in. Guard code has been added to avoid this error, but MCPE itself needs to be fixed in order for all snow thicknesses to be correct <I>(Thanks to Tate B. Hickman for reporting this bug)</I>. 
<LI>You can now specify the terrain file(s) to use on startup on <a href="scripting.html#clo">the command line</a>; use "-t terrainExtYourfile.png".
<LI>The elevation shading and lighting setting is now saved, and restored using "Import Settings."
<LI>Fix export progression system so that progress shown during export is a bit more proportional to the time actually used.
<LI>If TileMaker's normals terrain file is present, Export normal map textures within the OBJ export, for the "Export tiles" option.
<LI>Numerous small cleanups and fixes.
<LI>Note: there is now <a href="https://github.com/TheWeirdSquid/Minecraft-Player-Head-Tools">an add-on for Blender</a> that fixes the <a href="https://github.com/erich666/Mineways/issues/13">"generic head" problem</a>.
</UL>

<LI>Version 7.19, 8/27/2020 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV719.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Fix problem of schematic export not exporting, and other gzip-related file close problems. <a href="https://github.com/OpenImageIO/oiio/issues/1817#issuecomment-439048464">This fix</a> introduced in 7.15 caused the problem.
<LI>Fix tile associations so that, when exporting separate textures, more materials will be properly flagged as emitters. Currently the pumpkin/jack o' lantern and the redstone block ore materials still are not separated into non-emitters and emitters.
<LI>To ease substitution of separate textures, any synthesized textures (where the grayscale texture is tinted by Mineways, such as for leaves and water, or composited textures, i.e., grass_block_side) are now identified by a suffix of "_y.png" to differentiate them from their original textures.
<LI>Fix output material name for grass_block_side to not include the word "overlay".
<LI>Properly do a full composite for grass side overlay tiles that have alphas between 0 and 255.
<LI>In TileMaker, update some alternate tile names to match Bedrock or other newer names.
<LI>Updated with new tiles from Sphax PureBDCraft and Doku Light 1.16.
<LI>Checked 1.16.2 terrain files. Happily, these are unchanged from 1.16.1.
</UL>

<LI>Version 7.18, 7/4/2020 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV718.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Improve TileMaker, now version 2.15:
<UL>
<LI>Test all input images to make sure their height is a reasonable multiple of their width. If not, give an error and ignore.
<LI>Test input chest images to ensure they are using powers of two. If not, give an error and ignore.
<LI>Add option '-z pathname' that lets the user point directly at the directory location where the texture pack has been unzipped. <a href="#protile">Documentation and example added</a>.
<LI>Show all errors at the end of the console output, so the user can easily see them.
</UL>
<LI>Update to the 1.16.1 final terrain tiles; only the "water_overlay.png" changed.
<LI>If the Terrain File and export settings lead to a single texture that is 16,384 x 16,384 pixels or larger, warn the user that this size can cause problems for other programs and give suggestions for better ways to export the data.
<LI>Add a few more (possibly useless) digits to the vertex texture coordinate output for OBJs, just to make sure we're doing the best we can when high resolution Terrain File textures are used.
<LI>Sphax PureBDCraft and other included texture packs updated a little with cleanups.
</UL>

<LI>Version 7.17, 6/27/2020 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV717.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Coral was getting converted to jigsaw pieces when underwater, because I missed masking off a "waterlogged" bit. I've also masked out other blocks' unneeded bits now when checking the subtype, just in case.
</UL>

<LI>Version 7.16, 6/20/2020 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV716.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Fix gaps due to path and farmland blocks not truly filling the full block. <I>(Thanks to roket333 for <a href="https://github.com/erich666/Mineways/issues/61">reporting this problem</a>)</I>
<LI>Fixed tiled texture output so that individual block export and other options work better.
<LI>Lower the lily pad by 0.5 in pixelspace <a href="https://minecraft.wiki/w/Solid_block">to match Minecraft</a>.
<LI>The export property "Material per object" is now called "Material per family".
<LI>Improve documentation for <a href="#obj_export_options">Wavefront OBJ export options</a> by adding an example, etc.
</UL>

<LI>Version 7.15, 5/30/2020 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV715.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Fix problem of reading empty (not yet created) chunks that have no Biomes array in them yet. <I>(thanks to Artiom Boyko for reporting this)</I>
<LI>Improved warning messages for when there are no worlds in the Minecraft save directory.
<LI>Fix <a href="https://github.com/OpenImageIO/oiio/issues/1817#issuecomment-439048464">conflict between zlib and MSVC for closing files</a>; use fclose instead of gzclose on gzipped files.
</UL>

<LI>Version 7.14, 5/20/2020 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV714.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Fixed problem of empty areas showing random terrain.
<LI>Fix Bee Nest color on map.
<LI>Added scripting option "Selection location: all" - which does not select <I>everything</I> in a world, but is a useful shorthand for selecting everything in a typical schematic file.
<LI>Fixed STL export so that all statistical data is properly added to the text file.
<LI>Fixed the problem of an imported STL .txt file causing the appearance of two texture export states.
<LI>If bad data is encountered, close the file with the problem (the code was always closing the model file).
<LI>Cleaned up dead links and other problems with the documentation.
</UL>

<LI>Version 7.13, 5/9/2020 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV713.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>1.16 beta 20w19a: added the 82 new block types, their behaviors, and the 4 new biomes. Newer betas can and will not work properly in various ways. Warnings added for when unknown block types are detected.
<LI>If a block type is unknown, replace it with air instead of bedrock, to make mismatches less intrusive. Warn that an unknown block was encountered, once per world.
<LI>Fix warning in TileMaker when tiles using the accepted name and the alternate name are both present.
<LI>Do not allow "Export individual blocks" when "Export tiles" is selected. I hope to make these two options work together in the future.
<LI>Untangle the quartz texture naming, so that now quartz block and smooth quartz use the correct tiles.
<LI>Fixed honey block so that the outer layer is all honey_block_bottom tiles. <I>(thanks to vktec for reporting this bug)</I>
<LI>Fixed bug where going from "Export tiles" to "Export full color texture" would change the scale of the model from 1 meter to 2 millimeters.
<LI>Made the following blocks light emitting, and scaled <a href="https://minecraft.wiki/w/Light">all emitter emission levels</a> properly: burning furnace, blast furnace, smoker, conduit, magma block, sea pickle, brewing stand, brown mushroom, dragon egg, end gateway, end rod, end portal, and end frame. Because of the non-physical nature of Minecraft emission levels, I chose to raise the "raw" emission value of emit/15 by the 1.5 power, since dimmer lights are considerably (not linearly) dimmer in Minecraft.
<LI>Fixed illumination on campfire flame and lantern chain material, along with the material on other blocks.
<LI>Snowy grass and podzol now show as white on the map.
<LI>Use proper colors for signs on map (when "Show all objects" is chosen).
<LI>Corrected redstone connectivity on sides of blocks, with TNT, redstone blocks, and sea lanterns now not blocking the flow if these block edges touch. Really, this is a tough one to explain... search the ObjFileManip.cpp code for BLOCK_SEA_LANTERN if you care.
<LI>Hashing errors with flowerpots and heads cleaned up. Sorry, no head textures added.
<LI>Reduce download size by using <a href="https://en.wikipedia.org/wiki/Pngcrush">pngcrush</a>. <I>(thanks to Morgan McGuire for the tip)</I>
<LI>Numerous other boring little fixes - see the numerous <a href="https://github.com/erich666/Mineways/commits/master">commits</a> for more.
</UL>

<LI>Version 7.12, 3/28/2020 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV712.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Added export option <a href="#make_groups_objects">"Make groups objects"</a> for OBJ export. This option makes every group formed into a separate object of the same name. It can help ease editing when exporting individual blocks, for example. <I>(Thanks to zero for reporting this problem.)</I>
<LI>Added file scripting/annotate_map.py, which annotates output maps with where each region file is located, along with other related scripts. Such maps can help you decide to delete remote regions from your world, for example. Read the top of the file for how to install Python and ImageMagick and then run this program. <I>(Thanks to Rob P for testing these scripts out.)</I>
<LI>Fixed script interpreter for "Zoom:" - input was incorrectly limited to between 1 and 15, not 1 to 40.
<LI>Added scripting/_README.txt to explain the sample scripting files. This is the least known, and most powerful, part of Mineways.
</UL>

<LI>Version 7.11, 3/5/2020 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV711.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Added <a href="#exportmap">"Export Map" option</a> to the "File" menu, and added "Export Map: my_map.png" command to the <a href="scripting.html#sic">scripting system</a>. Exports the selected area to a PNG. See the file "scripting/make_map_tiles.mwscript" as an example of how to export a set of maps, and "scripting/make_slice_maps.mwscript" for making cutaway animations. <I>(Thanks to Rob P and Ross for pushing for this feature.)</I>
<LI>Fixed bug with the scripting command "Select maximum height" in which the user interface did not show the change requested.
<LI>Added better error reporting for when ancient McRegion worlds or Bedrock world files try to be opened. <I>(Thanks to supercat 95 for reporting this problem.)</I>
</UL>

<LI>Version 7.10, 2/2/2020 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV710.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
Call this one the "Minutia Release," as <a href="https://www.reddit.com/r/Minecraft/comments/ej2kay/hold_shift_when_creating_a_world_and_switching/">the debug block world</a> in Minecraft helped me find a large number of fixes and cleanups:
<UL>
<LI>Tilemaker updated to version 2.12: The new 1.15 layout and images for chests is now supported (why Mojang changed it, I don't know). If a "normal_left.png" image is found in blocks/chests, all chests are assumed to be in 1.15 format, else 1.14 or earlier is used.
<LI>Bug fixed where water on top of inverted stairs or top-half slabs made the top face of these blocks disappear.
<LI>Bug fixed in which beehive and bee nest honey_level values were getting transferred to other blocks.
<LI>Free-standing bells were rotated 90 degrees from where they were. Free-standing bell supports now also have bottoms. The new "powered" data value in 1.15 is now handled.
<LI>Buttons placed on the top or bottom of a block now properly use the east-west vs. north-south property for orientation (<a href="https://github.com/erich666/Mineways/issues/51">issue report</a>).
<LI>Activator rails inactive/active states were reversed - fixed.
<LI>Observer blocks' powered state is now shown properly for 1.13 on (it worked under old 1.12 Minecraft format).
<LI>Shulker boxes now have orientations, and the default (no color given) shulker box is now purple (it should be a pale purple, but that's a lot more work and on the TODO list).
<LI>Torches now have bottoms.
<LI>Grass, dirt, coarse dirt, podzol, mycellium, grass path, sand, red sand, netherrack, and bedrock (180 degrees only) have their top and bottom faces randomly rotated, similar to how Minecraft does it, to break up repetition in large expanses of the block.
<LI>Better randomization functions added for plant placement, bamboo texturing, and chorus plant sections.
<LI>The default red bed tiles are updated to 1.15 versions. Still no colored beds, nor beds with solid legs.
<LI>Chests, scaffolding, and campfires (including burning ones - go figure) can now be waterlogged, as in Minecraft.
<LI>Waterlogged stained glass now retains its proper color.
<LI>Redstone repeaters and comparators now have shortened torches, for when they are on transparent blocks (the torch handles used to be visible under these circumstances).
<LI>Redstone repeaters now show the "locked" mode.
<LI>If farmland moisture level is not fully wet (0x7), output dry farmland.
<LI>Make average wet farmland map color brighter on the map.
<LI>Mycellium blocks are now snowy on their sides when there is snow on top of them.
<LI>If individual snowy grass, podzol, or mycellium blocks are exported, they will have snow on their tops.
<LI>Improve error message and behavior for when someone attempts to read in a Minecraft Bedrock world.
</UL>

<LI>Version 7.09, 12/7/2019 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV709.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Interpret 1.15 biomes correctly. Technical details: The 1024 integer array is 64 levels of 4x4x4 voxels. In Mineways only the 4x4 biome values for levels 64-67 (level 16) are used, the rest are ignored for now.
<LI>Bug fix: redstone wires should not run down the sides of upper-half slabs that have redstone on top of them and connecting to redstone a level below them. <I>(Thanks to Quinlan W again for reporting this bug)</I>.
<LI>Update to now build under VS 2019.
</UL>

<LI>Version 7.08, 11/29/2019 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV708.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Added 1.15-pre3 bee nest, beehive, honey block, and honeycomb block.
<LI>Added 1.15 biome reader, so we don't crash. <B>NOTE:</B> I haven't figured out how the 1024 integer biome storage works yet.
<LI>Made nether portal have true geometry instead of a whole block.
<LI>Bug fix: redstone wires should not run down the sides of upside-down stair blocks that have redstone on top of them and connecting redstone a level below them <I>(Thanks to Quinlan W for reporting this bug)</I>.
<LI>Bug fix: when using MCC ToolChest PE, the order of stair Properties is reversed, which revealed a subtle bug in Mineways when translating upside-down stairs' data values; now fixed.
</UL>

<LI>Version 7.07, 11/23/2019 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV707.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Bug fix: when stairs are put next to each other and "Export individual blocks" were chosen, the sides of the top part of the stair step were not exported - fixed <I>(Thanks to "Speaker" for reporting this bug)</I>.
</UL>

<LI>Version 7.06, 9/18/2019 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV706.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Wood (vs. Log) blocks for versions 1.13 on were getting turned into planks. The deforestation has been fixed; they're now properly wood blocks again. <I>(Thanks to Avatar2003 for reporting this bug.)</I>
<LI>Update import instructions for Maya.
</UL>

<LI>Version 7.05, 9/13/2019 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV705.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>The G3D viewer has been updated to properly handle tile texture output. This viewer works well with Mineways OBJ files and is highly recommended. <a href="https://erich.realtimerendering.com/minecraft/public/mineways/g3d.zip">Download this custom build here</a>.
<LI>Tilemaker is updated to version 2.10:
<UL>
<LI>Update the number of tiles that can be read considerably, since the number of input tiles can be higher than the number actually used. This avoids a crash condition for some resource packs.
<LI>If both the normal name and the alternate name are found for a tile, warn the user and save only the first tile found.
<LI>Doku Light and Doku High terrainExt PNGs now properly formed and included.
</UL>
<LI>Added <a href="#new_blender">import instructions for Blender 2.80</a>.
<LI>Changed tiled texture output and G3D full material options for Wavefront OBJ to not include an explicit "map_d" material. Most programs understand a diffuse RGBA texture to mean "use the alpha channel as a mask." Blender is an exception, and the instructions include how to use the Shader Editor to attach the alpha.
<LI>Fixed bug where a stray mouse move was generating out of bounds biome numbers, causing a random crash during import of previous OBJ export (can't say I fully understand this one, but I now protect against it).
<LI>Properly extend "set cutout pixels to background" to include the one-pixel "bleed" border, so that interpolation along cutout edges hitting the border is better.
<LI>The "Delete floating objects" option now works a bit better for rendering. If a block touches any other block's face (not just "full-sized" blocks, as with 3D printing), it is made part of a group and so is more likely to be properly preserved.
<LI>Made export dialog a bit more bulletproof when switching between texture output types (it's still possible to kill the program with weird enough combinations).
<LI>Cauldron feet are no longer cutouts in 1.14, but actual geometry, so geometry is now created.
<LI>Old-style (1.12 and earlier) potted acacia saplings and potted dark oak saplings are now exported correctly.
<LI>Properly place mob heads from 1.13 and 1.14 that are meant to go on the floor actually on the floor, instead of the wall. (Proxy carved pumpkins are still used for the heads, though.)
<LI>Fix built-in Block Test World to set valid test data values for all wall signs.
<LI>For "Split by block type," the block names are no longer output as "Block__Subblock" but rather "Subblock". This makes the block types less wordy and more sensible when exporting. Many names have been added. Some names have changed, to the newer names or for consistency:
<UL>
<LI>"Stained Clay" changed to "Colored Terracotta" (and sub-blocks are by color, e.g., "White Terracotta").
<LI>"Hardened Clay" changed to "Terracotta".
<LI>"Purpur Double Slab" changed to "Double Purpur Slab".
<LI>"Andesite Double Slab" changed to "Double Andesite Slab".
<LI>"Tube Coral Block" to "Coral Block", "Tube Coral" to "Coral", "Tube Coral Fan" to "Coral Fan", and "Tube Coral Wall Fan" to "Coral Wall Fan".
</UL>
</UL>

<LI>Version 7.04, 8/10/2019 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV704.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Fixed bug where "split by block type" was reporting sub-block names in the OBJ file, but still using numbers in the MTL file.
<LI>Some "manufactured" tiles were not bled along their edges properly, as bleeding occurred too early; also, semi-transparent alphas were ignored. All tiles are now <a href="http://www.realtimerendering.com/blog/png-srgb-cutoutdecal-aa-problematic/">bled to their edges</a>, to make mipmapping work properly.
<LI>Hide blocks 253 and 254, which are special internal IDs, in the [Block Test World] in release builds.
</UL>
(<I>Thanks to Chris Keller and MegRae for the reports on the "split by block type" bug and for testing my fix.</I>)

<LI>Version 7.03, 7/7/2019 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV703.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Fixed bug where the program crashed when missing blocks were visible when exporting. This had to do with the <a href="https://miztakenjoshi.wordpress.com/2010/01/27/unhandled-exception-0xc00000fd-stack-overflow">stack reserve size not being large enough</a>. Along the way I noticed empty chunks were not loading properly, leading to them getting loaded repeatedly. This is fixed, so such areas should be accessed more efficiently now, meaning a bit faster drawing when the view changes.
<LI>Added "-m" to the <a href="scripting.html#clo">command line options</a>, which minimizes the Mineways window on startup. This is useful for running Mineways fully automated with scripts.
<LI>Moved lily pad up a small bit (similar to redstone dust) to avoid z-fighting in the obscure case of a <a href="https://www.reddit.com/r/Minecraft/comments/c9r6qd/a_new_building_trick_that_might_come_in_handy">waterlogged slab</a>.
<LI>Changed "Cut" and "Smooth Sandstone Slab" to be a correct map color of beige, not red. Similarly fixed (polished) granite and smooth quartz slab map colors. Fixed "Emerald Ore" to not be red. Changed "Smooth Red Sandstone" to have the same map color as "Red Sandstone". Fixed "Sea Pickle" and "Turtle Egg" colors. Dimmed "Bell" color so it doesn't look like a light source. Added colors for some additional slab types: polished andesite, (polished) diorite, end stone brick, and (pure) stone.
<LI>Name fixes, for those who care: Fixed "Tall Grass" blocks to be named "Grass" and "Double Tallgrass" to be "Tall Grass". Fixed "Leaves" to be "Oak Leaves".
Fixed (the new) "Sandstone" to properly be named "Smooth Sandstone". Ditto with "Red Sandstone" to "Smooth Red Sandstone". Changed "Snow (layer)" to "Snow" and "Snow" to "Snow Block".
Changed "Monster Egg" to "Infested Stone". Brown and red "Mushroom (block)" to "Mushroom Block". Changed "Wooden Slab" to "Oak Slab" since there are sub-type names for all the different types. Changed "Weighted Pressure Plate (Heavy)" to "Heavy Weighted Pressure Plate", and same with "Light". Changed "Large Flowers" to "Sunflower". Changed "Red Nether Brick" to "Red Nether Bricks".
<LI>Added block sub-type names for "Wet Sponge", "Chiseled Sandstone", "Cut Sandstone" (ditto with the Red varieties), "Block of Quartz", and the "Mossy/Cracked/Chiseled Stone Bricks" (ditto with the Infested varieties, plus "Infested Cobblestone").
<LI>Cleaned up documentation a bit, fixing an error on the reference page and improving the text throughout.
</UL>
(<I>Thanks to Kawisz for noting the crash bug and providing a test case, the <a href="https://www.planetminecraft.com/project/dunov-class-heavy-cruiser/">Dunov-Class Heavy Cruiser</a>.</I>)

<LI>Version 7.02, 6/20/2019 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV702.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Added feature: separate tiles are written to a subdirectory, default name "textures". If no subdirectory is given, the tiles are written to the same directory as the OBJ and MTL file, as before.
<LI>Convert MWO_ chest tiles without cutouts to RGB only, no alpha, as alpha throws off some viewers.
<LI>Fix tab order on export dialog.
</UL>
(<I>Thanks to Patrick Crawford for suggesting the subdirectory idea.</I>)

<LI>Version 7.01, 6/15/2019 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV701.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>
<a href="#fcst">"Export tiles for textures"</a> option (now called "separate textures") added for Wavefront OBJ export. Now each tile can be exported to a separate texture image, making image substitution simpler and permitting mipmapping to work better. Updated Blender and Cinema 4D instructions.
<LI>
Added individual names to output of objects, e.g., instead of "Poppy__1" you will now see "Poppy__Blue_Orchid." Someday I'll take the time to make all these names unique.
<LI>
Added Red Sand, Log, and Bubble Column identifier names for mapping and output.
<LI>
The "F1" key now opens up the online <a href="reference.html">Mineways reference page</a> in your browser.
<LI>
Fixed lectern export: top was being exported twice (added test code to assert if the problem is encountered in the future).
<LI>
Fixed lantern and other export for Sketchfab, which was filtering out content unnecessarily.
<LI>
Added material names for types of stone and wooden double slabs, to match the single slab names.
<LI>
On export, texture coordinates are now labeled with their corresponding Minecraft block texture name.
<LI>
Bug fix: For Wavefront OBJ solid color export, export Tr = d - 1.
<LI>
Documentation revised, with all shortcuts moved to the <a href="reference.html">Mineways reference page</a>.
</UL>

<LI><B>Version 7.00</B>, 6/8/2019 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV700.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>1.14.2 support; turtle eggs updated from 1.13's odd texturing to instead match in size, as done in 1.14.
<LI>Finally fully fixed bug where repeating an export would output a relative-coordinate OBJ file instead of the user-chosen format.
<LI><a href="#texture_output">Texture output</a> RGB/A/RGBA now supported in scripting. 
<LI>Fix wall signs to be oriented properly.
<LI>Fixed bug in which new blocks were occasionally not exported if near the fringes of the export volume.
<LI>Models read in through "import settings" load faster, by avoiding a redraw caused by the color scheme being set unnecessarily.
<LI>When selecting, if water is detected, Mineways now chooses the lowest non-water block for the lower height.
<LI>The lower height is now renamed to simply "Depth," and "Max height" simply "Height."
<LI>Interpret the "single" chest property introduced in 1.13, so chests next to each other that are singles are shown as such instead of being joined into a double chest.
<LI>Fixed flower sizes and positions for flower pots.
<LI>Set and use <a href="https://minecraft.wiki/w/Waterlogging">waterlogging property</a> for more blocks (slabs, stairs, trapdoors).
<LI>Flowers, grass, and other natural objects are now given a consistent "wobble" in their location in the block, like Minecraft does (but not using the same algorithm as Minecraft, as I do not know their method).
<LI>Chorus plant blocks have added consistent randomness to their shapes.
<LI>Properly connect fences, gates, and walls to one another.
<LI>Properly orient piston head textures.
<LI>Added automatic proper initialization of "sort by block type" system masks for blocks.
<LI>Show on the status line that the model is being imported when read in with "Import Settings."
<LI>If the internal tile texture is used, instead of an explicit TerrainExt.png, no warning is now issued when reading back such exported files with "Import Settings."
<LI>Renamed "Split materials into subtypes" export option to the slightly-less-confusing "Split by block type," and expanded the documentation on this and related options.
<LI>Tilemaker updated with new lodepng library.
<LI>Numerous other fixes throughout.
</UL>
(<I>Thanks to Rafiti 2002 for pointing out that signs don't work in 1.14, that single chests can now be next to each other, and to the problem with autocorrect where the ocean does not get captured.</I>)


<P>
<LI>Version 6.08, 5/3/2019 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV608.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
For power users, especially if you use large texture tiles: added <a href="#texture_output">"Texture output"</a> checkboxes to dialog that suppresses the output textures being generated. //
Fixed the long-standing bug that OBJ exports for older versions of Cinema 4D would import with the textures applied radially. The problem was that Sketchfab set the OBJ export for rendering to be relative, not absolute, coordinates. For some reason, older versions of Cinema 4D would fail to read these; version R18.057 does not. Fixed by separating Sketchfab export values from the normal rendering export values. //
Improved user experience by having autocorrection of the bottom height be off by default for schematics or whenever the user has set the lower depth to 0.
Updated <a href="https://lodev.org/lodepng/">LodePNG</a> and modified it to use wide character strings, to fix a crash when terrainExt.png files with extremely large block textures, e.g., 512x512, were read in.
Change default for exporting models for Sculpteo to be millimeters, as their default has changed to this from centimeters.
Make TileMaker a bit more robust, giving an error if a non-power-of-two or other erroneous tile is found, but skipping the tile instead of aborting.
(<I>Thanks to Kevin Niestrat for showing how TileMaker mysteriously failed, to SolarPH for helping solve the Cinema 4D problem and for pointing out the flaw with autocorrection and schematics, and another user for reporting the large-tile problem.</I>)
<P>

<LI>Version 6.07, 3/8/2019 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV607.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
Modify reader to handle (pre) 1.14 file format change, namely, that there are now up to 18 horizontal sections and these can have -1 or 16 (out of bounds normally) for the Y value. Now Mineways can properly read pre-1.14 worlds with towers up to the maximum height without crashing.
Turn off warning that a directory in the world saves directory is not a world, since some users intermingle world and non-world directories.
(<I>Thanks to Justis for reporting the "bad world directory" problem, and Brian Jia for the 1.14 crash repro files.</I>)

<LI>Version 6.06, 2/17/2019 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV606.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
Coal ore in 1.13 was getting exported as iron ore, due to a "5" that should have been a "6". Bone blocks imported from 1.13 were not getting an axis direction, due to a missing AXIS_PROP flag. The new schematic format <a href="https://github.com/erich666/Mineways/issues/40">introduced by FAWE</a> crashed Mineways. No support for this new (and quite different than the previous) schematic format, but such files will generate a warning when read. A warning is now generated if 1.13 data is present when exporting a schematic (to the standard, old schematic file format). Properly tiled top of double chests so that level one mipmap looks better (i.e., for distant chests). Made many cppcheck cleanups to code; pass by value changed to pass by reference in world read and map display functions, which should be a bit faster.
(<I>Thanks to Maker26 and Hubert Theodore for reporting some of these problems</I>.)

<LI>Version 6.05, 1/27/2019 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV605.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
New control: Holding the control key while using the mouse wheel changes the lower height; holding the shift key while using the mouse wheel changes the max. height (this latter mode can be slow and laggy, since the map is regenerated on each click). TileMaker 2.08: work with 8x8 tiles properly, give more information about how to continue when a tile is not a power of two, and avoid crashing when given extremely large tiles. <i>(Thanks to Bear Bear, Raoul, and Felix Brekelmans for reporting these problems and suggesting new features</I>.)

<LI>Version 6.04, 10/10/2018 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV604.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
Critical fix for 1.13 content: potted cactus and dragon head models were not treated properly, causing bad data interpretation. Fix [Block Test World] to show 1.13 content properly, along with other data fixes in it. Make sea pickle model sealed on the top and add the "tendrils" when in water. Update documentation about <a href="downloads.html#mac">how to run under Mac</a> and <a href="downloads.html#linux">Linux</a>. Updated custom texture packs and included bed part names in Tilemaker, which has a new minor release, 2.07. 32-bit versions removed entirely.

<LI>Version 6.03, 9/24/2018 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV603.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
Worked around critical export bug: strange memory corruption from GetSaveFileName() that makes 3D print export not work correctly. "Fixed" by saving value before and restoring it after these calls. Ugh. Brightened grass and leaf color export to more closely match Minecraft; old code multiplied the tile's average green by its grayscale texture, when the brightest green should have been used. If too bright for you, use a color scheme to make the leaf color darker. Fixed furnace, dispenser, dropper, and observer tiles so that their tops perfectly match Minecraft's orientation.

<LI>Version 6.02, 9/14/2018 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV602.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
Fixed critical tiny model bug: models with torches were scaled down to a tiny size. Added <a href="scripting.html#sketchfab">Sketchfab scripting</a> <I>(thanks, Aur&3acute;lien!), moved to zlib 1.2.11 (sadly, doing so does not fix the 32 bit version's crash on startup in this library)</I>.

<LI>Version 6.01, 8/6/2018 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV601.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
Fixed dead bush bug; grass was getting converted to dead bushes, due to a data value error in nbt.cpp <I>(thanks to Ebrahim Hamama for reporting this)</I>.

<LI><b>Version 6.00, 8/1/2018</b> - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV600.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
Moved to Visual Studio 2017, Windows SDK 10.0.17134.12. Added 1.13 translation - note that schematic export from 1.13 is iffy, since schematic does not support the new blocks. Added brown and red mushroom blocks "all cap" and "all stem" modes. Podzol with snow on it now properly turns snowy on its sides. Properly show bin direction for activated hoppers. Placed the active comparator output torch down two pixels to proper position. Fixed missing polygon bug of cobblestone walls connecting to fences. Connected fences together, even if of different types (this fixes one error, introduces another; nether fences should not join with wood, for example). Proper icons for the "structure block" block type is now shown. Fixed bad placement of mob head facing west (but, no, I have not added heads, it's still the pumpkin). Biome names updated, and a few temperatures updated.
On the TODO list: The Windows 32 version crashes on startup; need to fix that so the Mac version can be made. The custom terrain packs are not updated in this version. The "[Block Test World]" is not updated with 1.13 content, nor are Color Schemes. On export, <a href="https://minecraft.wiki/w/Waterlogging">Waterlogging</a> is not fully supported, and 3D prints should translate waterlogged plants to be water. Chests next to each other, not allowed in 1.12.2, will cause odd, faulty exports. Bed colors are ignored. Biomes 40-50 rainfall values are not known. Sea pickles do not have their tendril when in water. Flattened coral fans don't appear to composite correctly. Turtle eggs and sea pickles don't have the exact patterns seen, nor are the right sizes and textures. Conduit does not have the exact textures used. The nether portal should not fill the block. Basic scripting works, but block editing is not tested (and 1.13 blocks need to be documented). These problems are all fixable, but each will take some time and effort.


<P>
<LI>Version 5.10, 8/10/2017 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV510.zip">exe</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac510.zip">Mac 32-bit only</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Limited world list to 50 entries, as there seems to be <a href="https://github.com/erich666/Mineways/issues/31">a problem checking files</a> if there are too many worlds in the "saves" directory.
<LI>Provide more detailed and explicit instructions and information about errors when opening files.
<LI>Use the backslash everywhere in the path for opening files, just in case that's a problem on some systems.
<LI>Properly truncated world's name for Sketchfab title.
</UL>

<LI>Version 5.09, 6/9/2017 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV509.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Added observer and shulker box texture support, along with 1.12 beta glazed terracotta, concrete, and concrete powder textures.
</UL>

<LI>Version 5.08, 6/5/2017 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV508.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Subtract a bug, add another: fix gaps when an elevated slab is next to a normal step. <I>(Thanks to Vervez for reporting this bug.)</I>
</UL>

<LI>Version 5.07, 6/4/2017 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV507.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Properly cull unneeded geometry for inverted stairs. <I>(Thanks to Vervez for reporting this bug.)</I>
<LI>Properly make stairs and other complex blocks have tops and bottoms output if at border when "create block faces at the borders" is on.
</UL>

<LI>Version 5.06, 1/19/2017 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV506.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Fix the test for player location so that purely server-side worlds can be loaded. <I>(Thanks to Shannon Vaughn for help in finding this bug.)</I>
<LI>Give a better warning if an Education Edition world is detected, explaining how to proceed.
</UL>

<LI>Version 5.05, 11/2/2016 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV505.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Fix the <a href="scripting.html#clo">command line options</a>: these were getting entirely ignored due to some dumb code I added in a previous release.
<LI>Serious bug-proofing: avoid hanging if a bad level.dat file is encountered. Instead, ignore the world and warn the user. <I>(Thanks to AttackPlayz for helping me track this down.)</I>
<LI>Fix highlight selection so that empty block locations (holes to infinity) are highlighted when selected, in keeping with 5.04's new highlighting display.
<LI>Now that the G3D viewer doesn't need it, don't double the Ke material attribute values in OBJ output when the G3D material is used.
<LI>Make transparent materials in OBJ output with a tiny bit of Ks reflectivity by default, which looks nicer in G3D.
</UL>

<LI>Version 5.04, 10/7/2016 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV504.zip">exe</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac504.zip">Mac 32-bit only</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Stand-ins are in place for the Minecraft 1.11 beta observer and shulker boxes. The new textures for these are not yet integrated into Mineways, as I don't like to integrate blocks and their texture names until the release is official. For now you'll get something approximating these new blocks.
<LI><a href="#material_subtypes">Material subtypes</a> can be output: for example, Stone has seven types. Normally only one material, "Stone", is output, but you can have "Stone", "Stone__1", "Stone__5" for each type used, by its data value.
<LI>Command line option added: you can specify the folder where your Minecraft world save folders are stored, if you want to use another directory location. The format is <a href="scripting.html#clo">-s directory</a>. <I>(Thanks to <a href="https://www.reddit.com/r/mineways/comments/50hvj1/suggestionsbugs/">this redditor</a> for this suggestion.)</I>
<LI>The selection box now shows against empty or missing blocks. <I>(Thanks again to <a href="https://www.reddit.com/r/mineways/comments/50hvj1/suggestionsbugs/">this redditor</a> for this suggestion.)</I>
<LI><a href="http://minecraft.wiki/w/Flower_Pot">Flower pots</a> are fully supported for rendering, as <a href="http://minecraft.wiki/w/Chunk_format#Block_entity_format">block entities</a> are now read in. Reading in block entities was involved...
<LI><a href="http://minecraft.wiki/w/Mob_head">Mob heads</a> are properly scaled and positioned, but are still rendered as pumpkins. Adding the real heads is on the TODO list, but involves using unwrapped textures; the dragon head in particular is elaborate. Note that with <a href="#material_subtypes">Material subtypes</a> feature the different heads will be identified by their material.
<LI>Efficiency/bug fix: 3D print OBJ models were exporting with separate materials and groups. These are unnecessary, as is the alpha channel texture output. However, if exported using a single material, the alpha textures were getting used. Fixed.
<LI>Import of models exported from the Nether and The End using Import Settings now switch to these world types on import. Only models exported from this or later versions will contain the "View Nether" and "View The End" header information needed for this to work.
<LI>Automatic height adjustment when using Hide obscured (usually on in the Nether) now takes this feature into account, to give a better bottom starting height.
<LI>Monster eggs now output mossy, cracked, and chiseled stone brick versions, a 1.7.2 change I finally noticed.
<LI>End portal frames now show the eye of ender if present, and are rotated (though not 100% compliant, as I don't want to mess with adding a bunch of rotation flags).
<LI>Pumpkins and Jack O' Lanterns now show the faceless varieties (data value 4).
<LI>Centering the model around the origin now maintains coordinates. That is, if you use color schemes to select various blocks for export and centering is on, each export will use the same centered coordinates. Prior to this fix, each export would be centered around whatever <i>blocks</i> were output, meaning that different exports of the same volume would not align. Some renderers such as RenderMan need all transparent faces. This improvement lets you export water or other transparent objects so that they generate all faces, not just those faces that border air, though you have to perform two exports to do so. I might add yet another checkbox for having transparent surfaces always generate faces...
<LI>Bug fix: A block with vines hanging on all 4 sides and with the bottom covered could potentially crash Mineways. Array sizes increased.
<LI>Bug fix: If lesser block export is turned off for rendering, composite overlay must also be off, as the whole "small object" subsystem is not used. This bug caused a crash. <I>(Thanks to <a href="https://www.reddit.com/r/mineways/comments/50hvj1/suggestionsbugs/">this redditor</a> for reporting this bug.)</I>
<LI>Bug fix: Anvil top blocks were output twice, causing the top of the anvil to not show correctly.
<LI>Bug fix: Acacia and jungle saplings were getting turned into oak and spruce saplings, due to masking out the two high data value bits.
<LI>Bug fixes: The export options for OBJ were getting trashed when VRML or STL export was done first. Also, some options that were supposed to be unchangeable could be changed. I think I fixed this system now...
<LI>Bug fix: Areas with X or Z coordinates outside of the -1,000,000 to 1,000,000 range would give an out of memory error, due to some lazy bounds testing I put in. Changed 999999 to INT_MAX, -999999 to INT_MIN throughout the code. <I>(Thanks to David Ng for reporting this bug.)</I>
</UL>

<LI>Version 5.03, 8/22/2016 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV503.zip">exe</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac503.zip">Mac 32-bit only</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Serious bug fix: stairs improperly causing full faces to disappear, due to the data value of the stairs being cleared when output. That's what I get for trying to tidy up.
<LI>The "Open..." command now reads in a schematic as a map, for ease of exporting.
<UL>
<LI>For schematics, only, Control-A will select the whole schematic model.
<LI>If you save or rename your schematic file to have the world "repeat" in it, e.g., rename "eiffel.schematic" to "eiffelRepeat.schematic", the schematic will load and be repeated across the map, with a minimum one block gap between each model. This can be useful if you want to create a single 3D print file that has multiple copies of the model.
<LI>FWIW, I've added to Planet Minecraft <a href="http://www.planetminecraft.com/project/block-test-world/">a schematic of the Block Test World</a> that comes built-in to Mineways.
</UL>
<LI>The <a href="#seal">seal off entrances checkbox</a> now automatically attempts to fill in small window and door openings in houses and fill the interiors, without having to place torches.
<LI>Bug fix: properly select the correct color scheme when adding or deleting color schemes.
<LI>Bug fix: properly mark The End as on when chosen from the menu.
<LI><a href="https://github.com/JMY1000/CyclesMineways">CyclesMineways</a> scripts updated.
</UL>

<LI>Version 5.02, 8/4/2016 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV502.zip">exe</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac502.zip">Mac 32-bit only</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
<UL>
<LI>Critical bug fix: properly find minimum height when selection is performed.
<LI>Critical bug fix: schematic file export broken due to filtering out smaller blocks.
<LI>Bug fix: Import Settings now will properly read in STL ".txt" information files, so work can be resumed.
<LI>Bug fix: scripting export of schematic files now properly saves as a schematic.
<LI>Bug fix: when a new world is loaded, properly display reset slider depths.
<LI>Bug fix: ignore case when comparing most strings in scripting system.
<LI>Improvement (I hope): "Custom printer" material added and used by STL export, set to PLA characteristics by default.
<UL>
<LI>Costs for volume &amp; handling, currency, and minimum wall size can now be set by using <a href="scripting.html#soc">script commands</a>.
</UL>
<LI>Hardened clay (#159) changed to stained clay; tinted clay (#172) changed to hardened clay.
</UL>

<LI>Version 5.01, 7/5/2016 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV501.zip">exe</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac501.zip">Mac 32-bit only</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>.
<BR>
See <a href="https://sketchfab.com/models/53f7adafaca44a5b8ef1692a47fa03ac?annotation_cycle=8">this model</a> for a runthrough of the improvements made to rendering export.
<UL>
<LI>Added 1.10 blocks.
<LI>Full 1.9 support, leaving 1.8 truly behind: isolated iron bars and glass panes are now simple posts, redstone wire and overlay textures used, water overlay used.
<LI>Added block face offset for rendering: instead of composite tiles, where a new texture is created for say a ladder on a wall, the ladder face is rendered offset by 1/16th. If you encounter z-fighting problems, turn <a href="#composite">"Create composite overlay faces"</a> on.
<LI>Torches simplified and improved: less polygons, work better with Sketchfab, Sphax, and other texture packages.
<LI>Chests and ender chests now are properly created and fully recorded in TerrainExt.png.
<LI>Redstone wires are now shown with their proper on or off state.
<LI>Autocorrect for the level on initial selection now ignores semitransparent blocks by default, so including the bottom of lakes and coastlines. It also looks one block outside the border, so that cliffs are properly shown.
<LI>Space bar now corrects the bottom height, ignoring transparent blocks, which is useful when adjusting the selection area. Holding shift with the space bar does the same, but pays attention to transparent blocks (better for 3D printing, where we don't care about the bottoms of lakes and oceans).
<LI>Added "V" mode for script command "Select minimum height", see <a href="scripting.html#uie">the docs</a>.
<LI>Water tile is now left as is, no longer modified by the alpha set in the color scheme.
<LI>The enchanting table now is the proper size (no book, though).
<LI>Pumpkin and melon stems fully rendered at maturity, and rotated to proper position. Color's still not exactly right for each... next version.
<LI>Glass panes and iron bars properly sized and top and bottom edges rendered.
<LI>Tripwire hooks (but not tripwires) added. Giant time suck, but now all blocks have a real rendering, not a stand-in decal.
<LI>Flower pots emptied if version is 1.9 or higher (now that we can finally check the map version). I'll fix this fully someday. <i>(thanks to JMY1000 for <a href="https://github.com/erich666/Mineways/issues/14">the report</a>)</i>
<LI>Sunflower rotation angle fixed.
<LI>Tiles stretched better for full block 3D printing export.
<LI>Glowstone now does not chop redstone wire going over an edge.
<LI>If a tile is not a power of two in width, TileMaker now flags an error and exits.
<LI>Export full path to terrain file, for easier use when using Import Settings.
<LI>Fixed chunk edge error when using "Create block faces at the borders".
<LI>Reduced face loop storage size by about 30%.
<LI>Removed default composite tiles, since the system generates these and there is now plenty of space for composites.
<LI>Forced some pop-up messages to be topmost, since they're important and sometimes get lost.
<LI>Added status information when script is run, showing file currently being exported.
<LI>Plugged some small memory leaks.
<LI>Removed tiles.h from TileMaker area, directly use the Mineways/Win version, to avoid file duplication.
<LI>Documentation streamlined, putting more useful stuff first and consolidating troubleshooting.
<LI>Moved Windows 32 version of Mineways to separate directory, included msvcr120.dll's for both versions.
<LI>New icon! <i>(thanks to JMY1000 for <a href="https://github.com/erich666/Mineways/issues/12">the idea</a>)</i>
</UL>

<LI><B>Version 5.00, 6/10/2016</B> - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV500.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>
<UL>
<LI>Moved to Windows 10 redistributables. If you get an error about MSVCR120.DLL being missing, you'll need to install the Microsoft Visual C++ 2013 Redistributable Package for your system. Select vcredist_x64.exe for your 64-bit system, vcredist_x86.exe if your system is 32 bits. To find out if your computer is running a 32-bit or 64-bit version of Windows, follow <a href="http://www.computerhope.com/issues/ch001121.htm">the instructions here</a>, which come down to "hold down the Windows key and then click the Pause|Break key, then look for System type".
<LI>Added <a href="scripting.html">scripting support</a>. This is a huge deal if you're a serious user.
<LI>Added <a href="reference.html">quick reference page</a>.
<LI>Added a separate <a href="https://erich.realtimerendering.com/minecraft/public/mineways/g3d.zip">G3D viewer download</a>, explained <a href="#g3d">here</a>, with special controls to maintain Minecraft's blocky look.
<LI>Added <a href="#obj_export_options">material per type or per block</a> as an option for individual block export.
<LI>Fixed rendering output to be 1 meter per block. If you want it back the old way, change "Make each block" back to 100 mm from 1000. You can even use <a href="scripting.html">scripting at startup</a> to do this automatically.
<LI>Changed torch shear to rotate the torch instead, to match torches in 1.8 and newer.
<LI>Made signs thinner to match Minecraft's.
<LI>Changed hotkey to close app from Ctrl-W to Ctrl-Q (quit), to get it further away from other keys.
<LI>Removed "B" hotkey - <i>I</I> don't even recall its intent.
<LI>Fixed export scale radio button control (fix tab order).
<LI>Fixed bug introduced in 4.17 where single-material export failed.
<LI>Generalized "Import Settings" code to be more flexible and forgiving: it will now read in the world, terrain file, and color scheme from a previously-exported model file, as possible (4.18 files always set all three of these).
<LI>Made names of blocks exactly match those at the <a href="http://minecraft.wiki/w/Data_values/Block_IDs">Minecraft wiki</a>, so they can be used in scripts.
<LI>Fixed lesser blocks case of water on top of an upper slab, so that top of slab gets removed.
<LI>Cleaned up step export for 3D printing, when using the "lesser blocks" mode. A few less faces are now exported when adjoining stair blocks match exactly, which may help some 3D printer slicers get it right.
<LI>Lots of other little changes, hopefully for the better.
</UL>


<P>
<LI>Version 4.17, 4/24/2016 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV417.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - The world name and the world save folder name are both displayed for "Open World," since I was finding the world folder name was not sufficient. Moved Reload World menu item to be under File. Fixed export of rails, redstone, snow, and other "flat" decals onto partial blocks such as slabs. Two fixes with fluid export for detailed 3D printing; the mesh is now properly formed (I think). Removed all solid color texture output, freeing up a large area of the texture for "composite" tiles, such as redstone on logs, railway tiles, and more. The +/- keys (along with Page Up/Down and E/Q, as before) now zoom in and out. This is handy for small laptop keyboards, and because I forget that E and Q zoom. Color Scheme now has a "Hide Tree Blocks" to remove all log and leaf blocks, making terrain printing easier (trees tend to be delicate and break off). Sculpteo's prices have come down about 20% for colored prints, so the price estimate has been adjusted. // Deleted Windows8 executable; see the <a href="downloads.html">installation notes</a> if you think you need it. You should just install the VC redistributables described there.

<LI>Version 4.16, 3/13/2016 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV416.zip">exe</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac416.zip">Mac 32-bit only</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - Sketchfab <a href="#sketchfab">export option</a> added. Added <a href="http://resourcepack.net/modern-hd-resource-pack/">Modern HD</a> texture file terrainExt_ModernHD.png (<I>thanks for permission, <a href="http://resourcepack.net/modern-hd-resource-pack/">Mikeyto1o</a></I>) and removed unmaintained LB Photorealism texture file.

<LI>Version 4.15, 3/7/2016 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV415.zip">exe</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac415.zip">Mac 32-bit only</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - Minecraft 1.9 blocks added. 1.9-specific changes <i>not</i> added (these will come in 5.0): new "single" iron bars and glass panes, new redstone line patterns, and new still water texture next to glass. // "The Void" biome added (well, that's been in there for a while). Fixed biome button turning off after an export. Fixed crash when "richer color textures" selected. Fixed haystack to display properly when horizontal. Fixed potato and carrot growth to properly match tiles. Added up and down buttons. Fixed pack ice to properly join to fences. Fixed fattened fences to always output their posts, and cobblestone walls to remove the post only when the fence forms a line. Pumpkin and jack o' lantern stems on whole blocks now properly oriented. Glass panes now properly don't connect to water, lava, and chests. // Improved world search for Mac users (from Aur&eacute;lien Chatelain). "Show all" now shades transparent objects and mouse-over shows these objects. Increase block status window as application is resized to be wider. Fixed bug of File|Open... not working after using File|Open World. Properly update mouse-over status when changing view. Fixed bugs and inefficiencies related to switching to Nether and The End. Fix: if you switch from color STL to ASCII STL exporting, the material is now set to have no color and so will not give a warning. Escape key deselects area selected. F1 and ? pop up "About" dialog. // TileMaker now has two more options, -s and -S, that produce a solid (average) color terrainExt.png file. The "-S" option preserves the alpha cutouts. This texture allows greater control of solid color blocks, as you can set every face type as desired by changing its tile when using TileMaker, versus using the single color used for a particular block ID. // Latest <a href="https://github.com/JMY1000/CyclesMineways">Blender Cycles importer script</a> included.

<LI>Version 4.14, 1/9/2016 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV414.zip">exe</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac414.zip">Mac 32-bit only</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - Made the "bleed" process for cutout objects (flowers, mushrooms, and more) always happen; it used to be done only when the G3D material was selected. Performing bleeding keeps the fringes of these objects their proper color. See <a href="https://skfb.ly/JPH8">this</a> and <a href="https://skfb.ly/JPH6">this model</a> to see the difference, and for further explanation. Added <a href="#leaves_solid">an option to make tree leaves solid</a> for rendering, which vastly reduces polygon count for forests. Added an option to not <a href="#border_faces">export the bottom and side "box limit" polygons</a> for rendering, to lower the polygon count and allow better export tiling. Changed the alpha map to have the alpha value in all four channels, so that <a href="https://skfb.ly/JQJM">Sketchfab</a> properly displays the model by default. Increased thickness of "Block Test World" for better testing. Fixed bug in version number output to the various model files (there since version 2.24). Other minor fixes to vines and to the user interface.

<LI>Version 4.13, 11/4/2015 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV413.zip">exe</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac413.zip">Mac 32-bit only</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - <B>Folded the terrainExt.png's data into the program itself.</B> Now Mac users will never have to dig around to find this file. By default, if a terrainExt.png file exists in the same directory as the executable, it will be read in; if not found, the internal default terrainExt data will be used instead. This allows you to still customize the terrainExt.png file and have it get used by default. But, it also means that you can run Mineways entirely from the .exe itself, so on Windows could run it from a zip file, for example. // Fixed flower pot and cauldron export to avoid polygon overlaps and non-manifold surfaces.

<LI>Version 4.12, 9/10/2015 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV412.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - Added cycles_mineways.py script to set materials for Blender's Cycles renderer (thanks to Jonathan Edelman for this script), and updated documentation. Improved water export for printing, so that surface is manifold. Lengthened the "unassigned terrainExt.png" error message yet again, to help people out.

<LI>Version 4.11, 7/18/2015 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV411.zip">exe</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac411.zip">Mac 32-bit only</a>(flawed: missing terrainExt.png), <a href="https://github.com/erich666/Mineways/tags">source</a> - Fixed serious bug in STL export, where "individual blocks" was always being flagged as on; this causes uploaded models to look "skeletal." Improve Mac error for unassigned terrainExt.png file, explaining what to do next.

<LI>Version 4.10, 5/22/2015 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV410.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - Fixed initial view for some worlds, where spawn point was not being read in correctly (<I>thanks to Bob Irving for reporting this</i>). Fixed code to avoid infinite loop when modded world data is encountered (<I>thanks to Julian Drawdy for reporting this</i>).

<LI>Version 4.09, 1/6/2015 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV409.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac409.zip">Mac 32-bit only</a> - Fixed stairs output to obey all Minecraft rules (<i>thanks to James Ward for reporting this</i>). Fixed carpets, snow, and other thin covers to export properly as lesser blocks for 3D printing (<i>thanks to Justin F. for reporting this</i>). Fixed output of cocoa plant pods. Made objects all watertight when exporting using the lesser blocks option. Made the individual blocks option work for all blocks. Hollowing is now off by default for STL export, as home printers usually don't want to use this operation. Changed OBJ material output to use a white color when a texture is output, since these two elements are multiplied together for GLC display. Improved error messages, especially for reading PNGs. Updated to Shapeways' new cost scheme for white plastic prints; mine is an approximation of their complex algorithm, but gets fairly close. Synced to latest Shapeways constraint data. Added popular block texture names as alternate tile names to TileMaker by using the '-a' option, and give better diagnostics about unrecognized tile names.

<LI>Version 4.08, 10/22/2014 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV408.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac408.zip">Mac 32-bit only</a> - Major Mac version fix: worlds and terrainExt.png texture file is now found properly. Wall banners now display (with no pattern or color). Added normal per vertex for OBJ and fixed it for STL output, so that the GLC Player can display models better. Fixed vine and anvil normals. More object names are now displayed. Fixed color schemes so that old color schemes update properly to 1.8 format. Minor fixes to a few biome temperatures. Converted code's tabs to spaces for easier Github viewing.

<LI>Version 4.07, 10/14/2014 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV407.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac407.zip">Mac 32-bit only</a> - the little big one.
<UL>
<LI>Added Windows 8 executable, mineways_windows8.exe. You may need to install the 64-bit version of the <a href="http://www.microsoft.com/en-us/download/details.aspx?id=40784">Visual Studio 2013 redistributables</a> to be able to run it.
<LI>Added biome mapping mode: View | Show Biomes (or F8).
<LI>When biomes are displayed, elevation shading takes into account the altitude's influence on temperature for the biome. This effect is subtle, but it's there.
<LI>Biome of the center of the area chosen for export can be used to modify the grass, trees, and water color (yes, I'm getting closer to exporting multiple biomes, but that's hard).
<LI>Tilemaker 2.01: the grass_side_overlay.png texture is now used to properly form sides of grass blocks from scratch. If you make your own tile sets, you would be wise to rerun this new Tilemaker for best results.
<LI>UI improvements: arrow cursor shown when resizing is available.
<LI>Made mapping program output more (and better) colors, e.g., colored glass, carpet, and stained clay.
<LI>Added more map description (at lower left of window) for cursor location for tree types, flowers, and other blocks:
<UL>
<LI>Block ID and data value shown for cursor location when View | Show All Objects (F7) is on.
<LI>Biome type is shown when View | Show Biomes(F8) is on.
</UL>
<LI>Fixed semitransparent display: semitransparent objects now blend properly, and the cursor will report on only fully solid objects.
<LI>Color of grass, tree leaves, and other green objects are now truer to their Minecraft counterparts.
<LI>On the map, however, trees are shown in considerably different colors than used for export in order to make them visible vs. the ground, and easier to tell species apart. If you don't like these colors, turn on Biome display (F8) or make a color scheme for oak leaves (block 18) and acacia leaves (block 161) and set the color to say #6fac2d - a small color change of any sort will turn off this leaf display feature.
<LI>Better (I hope) block adding algorithm. When two blocks' edges touch diagonally on a horizontal edge and need to be joined, favor adding a block below vs. a block above.
<LI>Updated costs to match Shapeways' new prices for <a href="https://www.shapeways.com/materials/strong-and-flexible-plastic">strong plastics</a>. Shapeways' own site is misreporting machine volume needed, however, so there is currently a price mismatch.
<LI>Changed export dialog so that if various values are changed, the corresponding scale option is selected. More export options are grayed out for certain output modes that they don't influence (e.g., biome color export works only when full textures are used).
<LI>Made export dialog short and wide, so that it works better on 800x600 displays. Improved settings import instruction popup.
<LI>Emitter color increased to work with new <a href="#g3d">G3D viewer</a>.
<LI>Updated documentation, fixed stale links, added new prints to <a href="community.html">gallery</a>.
<LI>Bug fixes:
<UL>
<LI>Fix out-of-bounds data access for chest export in 3D printing.
<LI>Mouse selection off left or top edge now no longer wraps around.
<LI>"Debug floating parts" mode was crashing due to there now being more than 196 block types.
<LI>"Import settings" now properly reads files created using the cost or wall thickness criteria.
<LI>Progress meter fix, so progress now doesn't go backward.
<LI>Old double chests (without a data value) fixed to properly join up. Interestingly, these old chests simply disappear, they can't be seen in 1.8, even though their data is still saved in the chunks.
</UL>
<LI>Internal cleanups: removed extra fake wool block types, removed duplicate block definition data structures, increased map block cache size 5x for the 64-bit version, general C++ification of code from C.
</UL>

<LI>Version 4.06, 9/25/2014 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV406.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - Fixed biome read bug; biome and section order seems to be a bit arbitrary for some reason. Thanks to Tony R. for reporting this bug. Sorry, biomes not implemented yet.

<LI>Version 4.05, 9/20/2014 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV405.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - Fixed stair corner export bug; thanks to Chris Hutton for reporting it. Added name of world opened to title bar. Began biome work: biomes now read but are not yet interpreted. Fixed orientation of vines for south and east sides when rendering. Colors for grass, leaves, vines, stems, lily pads all adjusted to be closer to Minecraft's. Spruce and birch leaves now the proper hue of green for each.

<LI>Version 4.04, 9/1/2014 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV404.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - Fixed obscure bug: sloped rails exported to a detailed 3D print export had bottoms of the blocks missing, causing models to not be watertight. Small cleanups on when texture coordinates are generated, which should make some export files a tiny bit smaller. Attempted yet again to find the Mac Minecraft world saves area.

<LI>Version 4.03, 8/24/2014 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV403.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac403.zip">Mac 32-bit only</a> - Added more 1.8 beta blocks, including prismarine, sea lantern blocks, banners (minimal), red sandstone, wet sponges, coarse dirt, new wood fencegates, fences, and doors. Change block names to match <a href="http://minecraft.wiki/w/Data_values">Minecraft's names</a>. Added experimental colored plastic material and updated material costs and properties for Shapeways. Fixed wheat export for wheat near villages (was appearing as Netherrack); thanks to Duncan Alimchandani for reporting this bug. Fixed anvil rotation, better door texture borders, and other obsessive bug fixing. Improved "missing TerrainExt.png" warning for Mac users. Changed PNG exporter to optimize PNG file export, giving smaller files (note that older versions of G3D may not read these files, so <a href="#g3d">get the latest</a>). Allow TileMaker to convert the color black for a texture to mean an alpha of 0.0. Updated texture packs as possible. New Mac version from Psp4804 that no longer requires X11 or xQuartz.

<LI>Version 4.02, 6/22/2014 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV402.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac402.zip">Mac 32-bit only</a> - Added blender_mineways.py script to vastly simplify Blender import of Mineways models <I>(thanks to Wyatt Jameson and Nicky for this script)</I>. // Fixed extremely slow memory freeing of face records by replacing face allocation with my own pool system; large exports now proceed much faster. // Finally fixed the "two selections" bug, where if you made a selection and panned so it was offscreen, it wouldn't get cleared and could scroll back onto the screen, looking as if there were two selections.

<LI>Version 4.01, 6/20/2014 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV401.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - Fixed importer so that upper height is set properly. // Increased size of progress bar, so that progress is more visible for huge exports. <I>(thanks to Adrian Cowherd for the suggestion.)</I>

<LI><B>Version 4.00</B>, 6/18/2014 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV400.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - <b>64 bits</b>, at last! Mineways and TileMaker are now 64-bit executables. Now large exports will not fail due to running out of memory. Use the *32.exe version if you can't run 64 bits for some reason. Programmer's notes: switched to all C++ and a single build directory and project. 64-bit Zlib static library from <a href="http://www.winimage.com/zLibDll/index.html">here</a>, wonderful LodePNG (a replacement for libpng) from <a href="http://lodev.org/lodepng/">here</a>. // Minor change: "Set terrain file" now starts in the directory where mineways.exe itself is located.

<P>
<LI>Version 3.07, 5/29/2014 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV307.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac307.zip">Mac</a> - If you can't use the right mouse button, holding down "Control" will make the left mouse button act as the right mouse. // New <B>1.8</B> blocks added: Andesite, Diorite, Granite, Slime, Iron Trapdoor. // Piston head now properly created as geometry. // Trapdoors properly render at top of block. // Fences and walls properly join with transparent blocks. // Out of memory conditions now flagged as errors.
<LI>Version 3.06, 1/27/2014 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV306.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - Added option under "Help" that minimizes the amount of memory used during export. Use this option if you're running out of memory on large exports. This is not on by default, as this option will make exports take a few seconds longer. // Share some common export settings (color, material, block size, and more) among some related file formats. This is useful for when you export to both Shapeways and Sculpteo, for example. // Free the input TerrainExt.png file as soon as we're done with it. // Added automatic cache resizing and recovery for large map display.
<LI>Version 3.05, 1/1/2014 - <a href="https://github.com/erich666/Mineways/tags">source</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac305.zip">Mac</a> - Export "lesser" blocks more efficiently, removing many invisible polygons and so improving 3D print conversion. Added <a href="#importsettings">"Import Settings" feature</a>, which lets you read in a previously-exported Mineways file and match its export settings. Various bug fixes: proper export of "connect all edges", proper export of solid-color renderings, fixed some error messages to properly display.
<LI>Version 3.04, 12/10/2013 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV304.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - Allow export of partial blocks when saving without textures. // Set Ke and map_Ke for emitters' materials for OBJ, giving a better look when using the <a href="#g3d">G3D viewer</a>. // Properly output color swatches and other neglected modes. // Fix world name output for OBJ.
<LI>Version 3.03, 11/17/2013 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV303.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - Avoid crash when old-style terrain.png is used; warnings system improved. // Updated new Shapeways ceramics costs, and improved estimation by including partial block export. // Updated terrainExt*.png files Coterie, Doku, and BD Craft.
<LI>Version 3.02, 10/25/2013 - <a href="https://github.com/erich666/Mineways/tags">source</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac302.zip">Mac</a> - Move to <B>1.7.2</B>, adding all its blocks (exceptions: flower pots with acacia and dark oak saplings not supported). No looking back, roses are replaced by poppies and April Fool's locked chests are replaced by stained glass blocks. // True geometry added for glass panes, iron bars, levers, and brewing stands. // Redstone wires potentially running up block sides now are properly cut or not cut by various block types placed above them. // Many little texture fixes and rationalization of the code. For example, some billboarded objects (e.g., brewing stands, iron bars) now have a tiny epsilon between their front and back faces, to avoid z-fighting in G3D - I'm not sure this helps others.
<LI>Version 3.01, 10/17/2013 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV301.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - Serious color scheme crash bug fixed, due to array overrun. // The <B><a href="textures.html#tilemaker">TileMaker</a></B> is now available to help you make your own textures - see documentation. // Fire has been improved with more billboards, similar to Minecraft's style. // Torches are now sheared in Minecraft style instead of rotated. // The beacon's true geometry has been added for rendering.
<LI><B>Version 3.00</B>, 10/11/2013 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV300.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - <B>1.6 support:</B> at last, I tackled the new way Minecraft stores textures. This release no longer uses terrain.png files. Due to rules and format changes, an older version may serve you better: for 1.2 to 1.3 Minecraft worlds, use Mineways 2.22; for Minecraft 1.1 or earlier, use Mineways 1.15 (I don't even have a copy of either any more.... <B>Changes:</B> began <a href="textures.html#tilemaker">TileMaker</a> project to make custom terrain textures from texture packs. // Added mapping (only) for 1.7 - geometry to follow soon. // Setting a color scheme's air color sets empty spaces on the map to this color (even if the air is still transparent). This can be handy for making a nice background color for railroad maps, for example. // When a new world is loaded, the view is switched to the Overworld level, to avoid confusion. // Torches now have tops when exported for rendering. // New Shapeways materials added and cleaned up. // Fattened wood fences for 3D printing are now exported as stone wall shapes, for stronger support. // Mossy fences are now mossy for "non-detailed" 3D printing. // Fixed chest lock placement, and creation on test world. // Nether brick and quartz slabs/double slabs added. // Detector and activator rails now have active states. // Lots of other fixes you'll never notice.

<P>
<LI>Version 2.23, 9/3/2013 - <a href="https://github.com/erich666/Mineways/tags">source</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac223.zip">Mac</a> - Enable stairs to join under the 1.4 rules. Added "copy" for color schemes, and "OK" buttons. Added blocks up through 1.6.2, but mostly for mapping - the textures and some behaviors of the new blocks are not supported yet. Soon! Fixed "affects water level" property for some blocks. Fixed up direction stats format.
<LI>Version 2.22, 1/21/2013 - <a href="https://github.com/erich666/Mineways/tags">source</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac222.zip">Mac</a> - Bug fix: sometimes unknown blocks caused a timing error, making the "bad block" message repeat many times. Fixed, I believe... <I>(thanks to Michael Leone for reporting this bug)</I>
<LI>Version 2.21, 12/11/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV221.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - Stupid bug fix: I managed to break rendering support a bit, causing export to use the printing code path (slower and unnecessary). Now it works again. Minor feature addition: Sculpteo exports now have a somewhat better price displayed, but since I don't know their formula, it's still approximate.
<LI>Version 2.20, 11/30/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV220.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - <B>Major feature addition: schematic export</B>. See <a href="#schematic">the relevant documentation</a> for more information. Added version number to output file's comment header, to help in debugging. Fixed physical material name in output file's comment header (was printing just one character instead of the string). Fixed error message warning of bad blocks: further code added to handle this problem (thanks to Josh Smith for pointing out the problem). There is now an "unknown block" type that will show up on the map and on export, which looks like bedrock. As usual, you can remove these blocks by using a color scheme. Fixed bedrock properties (was listed as having transparency).
<LI>Version 2.19, 10/17/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV219.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - Added anvil. Fixed terrain.png to avoid rendering errors. Fixed crash on solid color export for rendering, and proper export for 3D printing. Added fire tile for 3D printing. Added path information to .OBJ header. Fixed texturing and placement errors for doors, cauldrons, and cocoa. Fixed texture clamping for furnaces, bed, and cauldron. Added color expansion (bleeding a decal's texture colors outward into the transparent parts) to improve rendering quality on various renderers. G3D/SAP export also now performs further color expansion. Improved error messages for Mac version - I still don't know how to detect Mac paths using MFC and WINE; advice appreciated. Added beta's stair "trimming" rules (where stairs at right angles will trim away part of the upper step), but this feature will not be enabled until 1.4 is released.
<LI>Version 2.18, 9/27/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV218.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - Output block size in statistics popup. Warn user if unknown block type is encountered. Add a "head block" placeholder (pumpkin) for now; it turns out to be hard to add the new beta's head blocks. Bug fixes: fix the scale dialog (the radio boxes got separated from one another). Turn default options (connect blocks, delete floaters) back on when "lesser blocks" option is turned off. Attempt to find Minecraft worlds a bit better on the Mac (no promises...). Remove warning about floaters when "lesser blocks" is used.
<LI>Version 2.17, 9/11/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV217.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - bug fixes: for cobblestone walls, pillars were not appearing on straight walls when objects were placed above the walls (thanks again to Sterling Babcock for the bug report). Also, in version 2.16 I tried to fix a problem for the Mac where it crashes for some users, possibly due to a memory use improvement introduced in version 2.09. I've turned this memory improvement back on in this version as it doesn't seem to matter for the crash.
<LI>Version 2.16, 9/8/2012 - <a href="https://github.com/erich666/Mineways/tags">source</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac216.zip">Mac</a> - bug fixes: fixed 3D printing color export for Sculpteo (OBJ) format viewed in SAP Viewer, fixed output of relative texture coordinates for OBJ export. Fixed color schemes so that old color schemes will auto-update when used with newer worlds. Provided guidance to Mac users looking for their world directory (still trying to figure out how to make this happen automatically). Added Xzip/unzip in anticipation of someday reading texture packs directly for textures. Added Ender Chest, but only for default terrain.png. Thanks to Sterling Babcock for bug reports and the Ender Chest texture addition.
<LI>Version 2.15, 8/28/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV215.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - Added "fatten lesser blocks" option, so that small features that are printed are less likely to snap off during manufacture. Removed "flatten blocks" option, since it's never turned off by anyone nowadays. Numerous minor tiled texture fixes. Fixed farmland output for printing. Added correct bed, cactus, and redstone repeater output for rendering and "lesser" 3D printing. Added sloped rails for 3D printing when "lesser" is on. Cauldrons with water levels added. Dragon egg geometry added. Command and beacon blocks added (default terrain.png only; beacon block is currently at 8,11), along with cobblestone walls, flower pots, carrots, potatoes, and wooden buttons.
<LI>Version 2.14, 8/4/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV214.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - Vines not exporting for 3D printing when the "lesser" feature was on. Fixed. Thanks to Sterling Babcock for reporting this bug.
<LI>Version 2.13, 8/4/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV213.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - Shapeways redesigned its upload page, now millimeters is the default model unit. Changed Mineways to export in millimeters by default, rewrote the documentation for Shapeways export.
<LI>Version 2.12, 8/3/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV212.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - critical bug fix for VRML export, I introduced a bug in version 2.11, in which the first few faces would not be exported. Thanks to Jonah Shafer for reporting this bug.
<LI>Version 2.11, 8/2/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV211.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - Added water and lava level export that matches Minecraft's; this always exports for rendering, and for 3D printing only when the <a href="#lesser">"lesser"</a> option is checked. Support sideways logs and upside-down levers in 1.3.1. Bug fixes: flipped tiles on "lesser" objects so they properly matched left and right. Rewrite of the UV texture coordinate system in anticipation of major changes for full support of Minecraft 1.3.1 (modest reduction of number of UV coordinates saved). Mineways will mostly work with MC 1.3.1, but note that 1.3.1 texture packs used with Mineways will make chests disappear (thanks, Mojang). Major rework is needed to fix this mismatch; the default texture pack will work fine for everything but Emerald blocks.
<LI>Version 2.10, 7/24/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV210.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - Fences, gates, doors, trapdoors, and sign posts are now exported for printing when the "lesser" option is used; see more details <a href="#lesser">here</a>. Options for tailoring OBJ export, and improved documentation on exporting to renderers.
<LI>Version 2.09, 7/20/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV209.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - Many new blocks have been added for rendering and for printing. These blocks are exported by default for rendering, and can be exported for 3D printing, by using the <a href="#lesser">"Export lesser blocks" option</a>. This feature is experimental (fences and fence gates are highly likely to break off, for example), and works with <a href="http://sculpteo.com">Sculpteo</a> but not Shapeways. See more details <a href="#lesser">here</a>. Flowers, mushrooms, tall grass, dead bush, saplings, and stems now are visible on the map and print as flattened decals (if you don't like this, disable using a <a href="#schemes">color scheme</a>). 
<P>
You can export again instantly with the same options and filename by using Control-X (or the File menu item). This is useful when adjusting bounds, fixing the world, reloading ("R"), or changing the color scheme and then re-exporting. File path is now retained for normal file export, also making adjusting easier. Material output has been simplified for OBJ, to improve import into Blender (though water now looks more boring in G3D - sorry; and just uncomment "illum" in the .mtl file). Absolute and relative OBJ have changed position on the file type selector, and 3D print firm names added when exporting for 3D printing. Changed default terrain.png to support all new Minecraft 1.3 blocks (note Emerald Block is shifted). Numerous fixes to [Block Test World] and block IDs added. Memory use has been considerably reduced, half or less of previous typical use.
<P>
Here's the list of blocks which now have correct geometry: slabs, stairs, fences and gates, farmland, signs, doors (but not for 3D print - too thin), pressure plates, buttons, snow, trapdoors, end portal frames, cocoa plants, and cake.
<LI>Version 2.08, 7/9/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV208.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - New features: individual block export and block test world added. See <a href="#individual">this section</a> of the documentation. Bug fixes: fixed export of redstone torches and repeaters, made vines always properly cover the underside of blocks, and made the bed texturing slightly better.
<LI>Version 2.07, 6/26/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV207.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - bug fix: huge mushrooms were not textured correctly, now they are.
<LI>Version 2.06, 6/19/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV206.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - Improvements: The lower depth is now autoadjusted for every new selection, and autoadjustment can be turned off. VRML rendering output is now grouped by material, for a bit more Cinema 4D support. VRML now exports to solid color and single color formats, for Ponoko support - many thanks to Ariock for and Ponoko for their help. VRML files now write out squares instead of triangles, reducing ZIP file size by about 20%. VRML files are now generated by default again, for previewing (generating just the ZIP is good for utter newbies, but a pain for everyone else). Various format bug fixes, including making rich color and floating object debugging mode work again. Unknown block ID check added, to future-proof Mineways and warn users of unknown block types. Week24 beta block additions are unofficially supported, though I'm ignoring the cocoa plant, and block of emerald is semi-supported (it conflicts with the old chest lid texture location - grrr).
<LI>Version 2.05, 4/12/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV205.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - Minor fix for rendering, only: vines are all turned into billboards. Vines are still a little funky for printing, but you'll never notice.
<LI>Version 2.04, 4/3/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV204.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a> - New option: whether to create the model files themselves. By default, VRML printing now exports only the zip, because people often upload the wrong file to Shapeways. If you want to preview the model, just check the "Create files themselves" checkbox. Loading a new world turns off the selection and resets depths. All terrain textures now updated to 1.2.4.
<LI>Version 2.03, 3/23/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV203.zip">exe</a>, <a href="https://github.com/erich666/Mineways/tags">source</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac203.zip">Mac</a> - Improvement: added a "Lower depth" slider to the user interface, making depth selection obvious and easier (thanks to Adrian Alan Brown for the suggestion). Misa textures updated to 1.2.4 (Coterie, Doku, LB, and Sphax have not been updated).
<LI>Version 2.02, 3/22/2012 - <a href="https://github.com/erich666/Mineways/tags">source</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac202.zip">Mac</a> - Updated to 1.2.4: added circle brick, different wood planks, and sandstone variants. Fix: swap spruce and birch saplings.
<LI>Version 2.01, 3/21/2012 - <a href="https://github.com/erich666/Mineways/tags">source</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac201.zip">Mac</a> - fixed various height bugs that slipped through the cracks. Wool now doesn't lose its color above height 127, for example.
<LI><B>Version 2.00</B>, 3/17/2012 - <a href="https://github.com/erich666/Mineways/tags">source</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac200.zip">Mac</a> - <B>Anvil support:</B> if you use Minecraft 1.2 or newer, use 2.x, else use 1.15. Hats off to Sean Kasun and some anonymous githubber, who did the heavy lifting in the conversion to Anvil. Source code <a href="https://github.com/erich666/Mineways/tags">uploaded to github</a>. Old North is now East. Added redstone lamps, added Sphax PureBDcraft and LB Photorealism terrain.png files and updated the rest to Minecraft 1.2.3, as possible. Fixes: now uses a little less memory in a few places, to help large exports. Repeater/wire connection fixed so that wires properly attach to only the ends of repeaters, not the sides. What used to be East is now North (the sun changed where it rose some time ago).

<P>
<LI>Version 1.15, 2/15/2012 - <a href="https://github.com/erich666/Mineways/tags">source</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac115.zip">Mac</a> -bug fix: scale error on warning of "too small" model for colored sandstone; Shapeways doesn't appear to enforce this rule, though. Fixed vines to export in a more reasonable fashion: composited with underlying objects and underneath trees, changed color, made background grass. However, vines still extend out beyond trees (see bug list). Removed right-mouse click for assigning "Bottom" height, as it's confusing and redundant; just use middle-mouse instead. Change "Z is up" to be default for i.materialise STL models. Add Show size in inches and centimeters in printout dialog. Fixed dragon egg tile location. Added beta jungle tile support in optional terrain_jungle.png: 9,9 wood, 4-5,12 leaves, 14,1 saplings. Replaced terrain.png with the game's default terrain.png plus flames, as it's better for printing. Added other terrain.png options. Removed alpha cleanup for print export, as it's unnecessary.
<LI>Version 1.14, 2/4/2012 - minor bug fix: extremely large chunks (those with say 100 chests full of objects) would not decode; fixed by increasing CHUNK_INFLATE_MAX. Improve selection highlighting: the selected area is always shown, and if some blocks are not selected the user is warned and corrective action applied (moving Bottom depth down). Note that when the depth is moved down, it is conservative, including visibility down deep holes, for example. Improve texture pack import: avoid using bad water, lava, and file tiles in custom terrain.png files - see <a href="#terrain_png">notes on terrain.png</a>. Statistics about the print's cost are now optionally displayed at the end of export.
<LI>Version 1.13, 1/28/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV113.zip">exe</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysSourceV113.rar">source</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac113.zip">Mac</a> - Improvements: you can reload your world by hitting the "R" key now. Loading a different world will recenter at spawn and unzoom the view. Bug fixes: Major fix is that wide characters are now supported on file read and write, which means characters such as "&aring;&euml;&icirc;&otilde;&uacute;" can be used in file names. These get simplified for material and texture file names, since those need to be UTF8 (well, more UTF7) for OBJ and WRL files. Fixed bugs with spaces in file paths. Resolved color mismatches for solid color output. Fixed a color problem with slabs when using solid colors (appeared in v1.12). Redstone torches were always flattened, now they appear properly in rendering output. Flames are now exported to be at the edge of blocks. OBJ export always has Y as up, for easier print preview with G3D. When exporting Magics STL without colors the header is made simpler, so the object does not preview as black.
<LI>Version 1.12, 1/25/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV112.zip">exe</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysSourceV112.rar">source</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac112.zip">Mac</a> - Bug fixes: half slabs of wood, sandstone, and other materials were all showing up as stone. Stronghold bricks were never cracked or mossy. Enhancements: "true specification" OBJ files are now output by default, since I figured out how to turn on previewing in Blender (see the tutorial). Blocks are now 1 meter in size when output for rendering, a scale that most rendering systems prefer and that I originally meant to be there.
<LI>Version 1.11, 1/19/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV111.zip">exe</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysSourceV111.rar">source</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac111.zip">Mac</a> - Bug fixes: spaces in texture file names baffles Shapeways' parser, so replaced with underlines; Wavefront OBJ "single material" output replaced by "true spec", where Ka and Kd are set to 0.2 and 1.0 for all materials - looks better in the SAP Viewer Complete. I also made "true spec" output absolute indices, for those readers that can't handle relative ones.
<LI>Version 1.10, 1/18/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV110.zip">exe</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysSourceV110.rar">source</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac110.zip">Mac</a> - Bug fix: default texture output not set for printing single-material OBJ. Fixed terrain.png read error message. Features: added emitter Ke output for emitters, though currently always '0 0 0'; this makes for easy identification and editing of emitters. Added internally a static, absoluteIndices, to allow positive indices to be output for OBJ files.
<LI>Version 1.09, 1/11/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV109.zip">exe</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysSourceV109.rar">source</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac109.zip">Mac</a> - Bug fix: was saving VRML PNG twice. Features: added <a href="http://en.wikipedia.org/wiki/Stl_file_format#Colour_in_binary_STL">Materialise Magics</a> as a color STL export format, defaulting to the settings <a href="http://i.materialise.com/">i.materialise</a> prefers. All STL now defaults to mm units, as this seems to be a common choice.
<LI>Version 1.08, 1/10/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV108.zip">exe</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysSourceV108.rar">source</a> - Files zipped before errors reported, output only those textures needed (and RGB for 3D printing instead of RGBA). Added fire billboard (your terrain.png must include it). Added dead bush and fern billboards.
<LI>Version 1.07, 1/9/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV107.zip">exe</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysSourceV107.rar">source</a> - If blocks were turned off and "seal off entrances" was used, some of the hidden blocks would reappear; fixed, and guard code added. If a warning was flagged, a ZIP file is not created; changed so that the zip file is always created.
<LI>Version 1.06, 1/8/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV106.zip">exe</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysSourceV106.rar">source</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac106.zip">Mac</a> - Major bug fixes: bubble population problem, group allocation, proper display of different neighboring transparent objects, sloped powered rails not displaying properly for printing, mushrooms not displaying as billboards for rendering. Added units selection for output. Added automatic ZIP creation for export. Separated cutouts from transparent blocks. Corrected <a href="http://casual-effects.blogspot.com/2012/01/translucency-in-obj-mtl-files.html">export of Tf for OBJ material file</a>. Added separation of textures into RGB and RGBA and alpha-only for better rendering import to 3DS MAX. Added "frosted detail" physical material.
<LI>Version 1.05, 1/4/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV105.zip">exe</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysSourceV105.rar">source</a> - Added two options: F7 makes little things like flowers and mushrooms visible on the map, and under File is "Select terrain.png for export", so a different terrain.png file can be used. Do not set the transmittance when using full textures for glass (assumes a cutout for glass). Other little menu cleanups, like what key selects the menu item.
<LI>Version 1.04, 1/2/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV104.zip">exe</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysSourceV104.rar">source</a> - Rendering gets some love: using "illum 4" kills Blender import, so back to "illum 2" for all but water, add "Tf" and remove "d" export; export "map_d" of the same texture map, making SAP Viewer work better with OBJ; change face offsets to be relative numbers instead of absolutes, so OBJ files can be added to each other.
<LI>Version 1.03, 1/2/2012 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV103.zip">exe</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysSourceV103.rar">source</a> - Added check to see if world reads properly, warns if not; added snowy sides to grass blocks when covered with snow; changed to "illum 4" for Wavefront OBJ export.
<LI>Version 1.02, 12/30/2011 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV102.zip">exe</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysSourceV102.rar">source</a> - added "hide all blocks" feature to color scheme dialog, fixed debug mode for separate parts so that it works properly if full textures are on (the textures get turned off) and so blocks always appear, don't export billboard torch if "Export all block types" is off.
<LI>Version 1.01, 12/27/2011 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV101.zip">exe</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysSourceV101.rar">source</a> - fixed depth going to -1, added warnings about models being too large, increased map cache size, improved model summary information at top of model file.
<LI><B>Version 1.00</B>, 12/24/2011 - <a href="https://erich.realtimerendering.com/minecraft/public/mineways/minewaysV100.zip">exe</a>, <a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysSourceV100.rar">source</a>. Here's the <a href="https://www.reddit.com/r/Minecraft/comments/nphd1/i_finished_mineways_a_free_program_to_3d_print_or/">announcement on Reddit</a>.

</UL>


<HR>
<h2 id="wishlist">Wish List</h2>
This is the wish list, in rough order of personal interest and bang for the buck. If you have a good idea, <a href="contact.html">let me know</a>. Most of these are frankly a ton of work to do for minor benefits, but I might as well keep track. If you want a feature and I can't or won't do it, consider adding it yourself! The code is <a href="https://github.com/erich666/Mineways">open source on github</a>. I'm happy to give advice and take pull requests. That said, the code's something that has grown over time and is obtuse in some areas.
<UL>
<LI>Cutouts with individual textures do not display correctly in G3D.
<LI>Individual block export does not currently work with individual textures. It should; the logic's involved... <I>(thanks to vktec for reporting this bug)</I>
<LI>USD: Glass (and water?) does not use a custom Minecraft.mdl type of exporter, which means edges of low-resolution textures are not sharp.
<LI>Add a script-only epsilon control for redstone wire and glow lichen for how far they're offset from the surface below.
<LI>Add a script-only "change the random shift of grass, etc." scale factor, 1 by default, 0 means don't jitter.
<LI>Process beds the same as chests, at least adding the red bed in this way. Careful of 1.15 vs. 1.13 differences.
<LI>Head, sign, and banner support (among others). Realistically, probably just head support, since the others would be a huge amount of work to emulate and could soak up a lot of texture memory.
<LI>TileMaker could "bleed" real pixels' colors into areas where alpha == 0, i.e., <href="https://asawicki.info/articles/alpha_test.php5">dilation</a>. This is done to a limited extent in Mineways itself; it could be done in TileMaker more thoroughly, and done only once, which would speed up export itself (which does this bleeding every single export). Problem with doing this is backwards compatibility.
<LI>Better USD instancing for water and lava, as right now a full block is what gets generated. Use "level" attribute?
<LI>Perhaps update redstone in 1.13 a bit with directionality and on/off, getting rid of distance. Can't do the "go up the side of the block" property, though, that would be 4 more bits. See next item:
<LI>Contemplate someday moving to a 16-bit data value instead of 8, and maybe a 16-bit type data value. If done, blocks could more precisely be generated (e.g., walls could work perfectly, redstone dots would work) and instancing for USD could be much better supported. Should be done in conjunction with a "max height" dynamic allocation of chunks, freeing up memory that currently is entirely air.
<LI>Multithreaded block loading, like Minutor does (or, well, did). This would make scrolling the map, making it huge, etc., much faster. Probably just a dream - hard work!
<LI>For TileMaker, instead of a blocks directory, read the *.jar or an unzipped directory structure to get the blocks, chests, bed, end portal, barrier, and anything else directly from the structure. Allow reading in a series of .jars and overlaying (analyze each first to get the maximum resolution needed overall). Then get rid of TerrainBase.png.
<LI>Consider reading in the chest, bed, and other elements (maybe shulker boxes - there are a lot of them, though) as separate textures in a separate zone (say, at the bottom) of the TerrainExt.png file, like in jmc2obj. Also allows direct export of these textures.
<LI>Analyze name of file given on command line. If it's a world level.dat file (or single world directory), load that world. This functionality is easy enough to do by <a href="scripting.html#clo">making a script</a> that loads the world, but having the program figure this out would be a nice little usability addition.
<LI>Add glTF export? Use <a href="https://github.com/Microsoft/glTF-SDK">this</a> or, better yet, <a href="https://github.com/syoyo/tinygltf">this</a>. Really, though, it's easier to upload directly to SketchFab and then make the model downloadable, as glTF is one of the options.
<LI>Zoom further out, allowing a wider view of the world. The main problems with this idea are that Mineways does not read blocks quickly and that selection becomes a bit imprecise.
<LI>Export all exported model elements to a Mineways script file as text commands, so that they can be modified by scripts or text editors and reloaded.
<LI>Use an installer for Mineways, such as INNO, so that vcredist.exe is properly installed. One more level of complication, though.
<LI>Add Bedrock/Pocket Edition/Education Edition support. Right now <a href="#mcpe">MCC ToolChest PE</a> and (maybe?) <a href="https://www.amuletmc.com/">Amulet</a> properly reads such files. This addition turns out to be a large bit of work, as the file format (Google's LevelDB) is entirely different than the NBT format used in the Java version of Minecraft, not to mention that Bedrock differs from Classic Minecraft in a huge number of ways. See <a href="http://minecraft.wiki/w/Pocket_Edition_level_format">this page</a> for details. Note that <a href="https://github.com/mcedit/pymclevel">pymclevel</a>, though it's in Python, may help in decoding the Pocket Edition format.
<LI>Add a "Go to location" dialog, where you give a location and the view is centered on it.
<LI>Almost out of space for composites. I've patched this by quadrupling the size of the texture output. Better would be to go to an "on demand" system, noting which tiles are used and outputting only these. That said, composites are used only for 3D printing, so we could aim to trim down that system.
<LI>TileMaker should handle non-power-of-two tiles. Warn the user, as before, but it should give it a go and resize.
<LI>Biome support: get biome color and use it to change terrain's output color. Currently only the biome at the center of the export is used to set the color of all blocks in the export. The hard part is blending (and saving all the resulting textures, a potentially large number) at biome margins.
<LI><a href="#blocks">Various blocks</a> could use more support, e.g., pumpkin and melon stems color, farmland wetness. This will use up more texture tiles, but that might be acceptable.
<LI>JSON support. Version 1.8 of Minecraft supports <a href="http://minecraft.wiki/w/Block_models">JSON descriptions of block models</a>. Supporting this would make adding new blocks fairly easy, as well as letting users make their own custom block descriptions. That said, it's a lot of work to add this.
<LI>Entities: there are <a href="https://minecraft.wiki/w/Entity">lots of entities</a>. I'll probably never add these, as they involve a lot of additional textures. But, it's on the list.
<LI>Full "lesser" block merging for 3D printing: right now smaller blocks such as fences are not merged properly with surrounding blocks to make a manifold, watertight mesh. This is done a bit for slabs and stairs and some other cases, by not generating a face if it's fully covered. However, for the most part I'm leaving it up to the 3D printer's software to properly merge these blocks together; I recommend using <a href="https://github.com/3DprintFIT/netfabb-basic-download">netfabb</a> for basic single-color-model cleanup. Some software does poorly with the current geometry, e.g., Sculpteo drops blocks. Adding a robust triangulator and the ability for a block to query its neighbor's face loops would begin to fix this problem. Insanely hard problem, so this is definitely in the "wish" category.
<LI>Better color selection: this is a weakness with the original <a href="http://seancode.com/minutor/">minutor</a>. Yes, you have to put in <a href="http://en.wikipedia.org/wiki/Hexadecimal_color">hexadecimal numbers for the color</a>.
<LI>Vines should work better for 3D printing. When they hang down without anything next to them, they have to be blocks, but when they're adjacent to trunks or other blocks they should go flat. That said, this doesn't look quite right: a vine on a trunk will be flat, but then if it hangs in the air it will fill the "outside" block. I think the answer is to shift the vine inward from whatever block it's in to the one it's touching, but intervening properly is tricky.
<LI>Shulker boxes would be nice to process from their separate composite image files, as we do with chests. Also, the "default" shulker_box should use its pale purple version.
<LI>Export color per vertex for baked-in Minecraft lighting. This <a href="https://github.com/erich666/Mineways/issues/79">idea has issues</a>, such as whether the time of day lighting should be combined with the local baked and ambient occlusion lighting.
</UL>

<h2 id="nightmarelist">Nightmare List</h2>
Just a joke name, but ideas I've pretty much ruled out at this point, and why. Listed in order from "some slight chance it could happen" to "extremely unlikely."
<UL>
<LI>In TileMaker, if there's an alpha for _e files, it should get folded in to make the color black as needed. For example, if an alpha is 0, set the _e for that pixel to 0. This will help avoid Tesellax pumpkin_face_on_e.png problem. But, really, Tesellax should fix its content.
<LI>Beds should have separate colors. Or not. These would take up a lot of tiles and kinda overload Mineways' texture storage space.
<LI>Consolidate flat areas of the mesh: large flat grassy areas are common in Minecraft worlds, as are large bodies of water. These could be merged into one giant polygon (for OBJ, with the assumption there's a good triangulator on the other end) or a better mesh that doesn't include all the interior vertices. There are two reasons that make me leery of this one, however. First, it won't work on the mosaiced single-tile texture output that Mineways uses by default, so it will only be useful for when exporting individual textures for every block face. For the giant single-texture mosaics used by default, the texture won't repeat on a simplified triangle mesh. Second, there's a question of whether to remove vertices along the edges of such areas. This will cause T-vertices, where the side of the block has a vertex but there's no vertex on the top of the block. This can lead to cracking artifacts when rendering. But, if you can remove the vertex on the side, too, then that's further savings. Basically, this problem can get pretty complex and tricky if you try to do a good job. Since it's only useful for the "individual texture" export mode, not the default for Mineways, this seems like a lot of work for few users. Most DCC apps already have such functionality anyway, e.g., see <a href="https://blender.stackexchange.com/questions/31467/how-to-reduce-vertex-count-on-a-mesh">this for Blender</a>. So, pass.
<LI>Work on Mac and Linux: my code is a Windows beast. Currently, Mineways works on Linux under Wine on Linux and the Mac. If someone wanted to make a Qt version of this code, great. The MinewaysMap subdirectory shouldn't need much work, it's just the Win subdirectory that is platform-specific.
<LI><a href="https://web.archive.org/web/20170912203020/http://www.minecraftforum.net:80/forums/mapping-and-modding/minecraft-mods/1272765-1-2-5-connected-textures-mod-v1-4-1">Connected textures</a> would give more continuous results for surfaces such as glass and bookshelves. One problem with this idea is that these are custom tiles, so this feature could be added for the default texture set, but not the various other texture packs. Not sure this is even still a thing at this point.
<LI>Integration with <a href="http://www.shapeways.com/api">Shapeways' API</a> and <a href="http://i.materialise.com/">i.materialise</a> API: Mineways could save each user a few minutes by directly uploading the resulting model files to Shapeways or i.materialise. While manually zipping and uploading is not a big deal, it's a bit of a pain to set the default material, add "Minecraft" as a keyword, and so on. These APIs would set all this information for the user, as is done by <a href="http://www.shapeways.com/blog/archives/1105-Minetoys-3D-Print-Your-Own-Minecraft-Character-for-Your-Desktop.html">MineToys</a>, <a href="http://www.3dtin.com/">3DTin</a>, and <a href="http://tinkercad.com/">TinkerCAD</a>. That said, this option is at the bottom of the list because I think it's the wrong workflow. Normally you want to export from Mineways and then use MeshLab or other program to preview the model to make sure it looks right, then you want to upload. Not checking the model before uploading seems over-optimistic to me in most situations.
<LI>Support for modded blocks. <a href="https://github.com/erich666/Mineways/issues/44">Sorry, no</a>.
</UL>

<P><H2 id="offsite">Links</H2>
Some links I commonly use.
<UL>
<LI><b><a href="https://groups.google.com/forum/#!forum/mineways">Subscribe to Mineways Google Group</a></b> for new version announcements; no spam.
<LI><b><a href="https://erich.realtimerendering.com/minecraft/public/mineways/mineways.zip">Download the latest Windows version of Mineways</a></b>. The following texture pack terrain PNG files are included for use with Mineways ("File | Choose Terrain File"), by permission of their creators (thanks!) - go <a href="#texture_output">here</a> to see previews:
<UL>
<LI> <a href="http://coteriecraft.net/">Coterie Craft</a> by Cpt. Corn
<LI> <a href="https://dokucraft.co.uk/">DokuCraft</a> by Hickerydickery
<LI> <a href="http://resourcepack.net/modern-hd-resource-pack/">Modern HD</a> by Mikeyto1o
<LI> <a href="http://bdcraft.net/purebdcraft-minecraft">Sphax PureBDCraft</a> (just the 64x64 - there are other sizes) by Sphax84
<LI> <a href="https://github.com/jasonjgardner/jg-rtx/releases">JG RTX</a>" by Jason J. Gardner
</UL>
<LI>Other platforms: Mineways works on Linux and the Mac under <a href="http://www.winehq.org/">Wine</a> - see link below (and I suspect it also works on the Mac using a <a href="http://lifehacker.com/5714966/five-best-virtual-machine-applications">virtual machine like VirtualBox</a> - let me know).
<LI><a href="https://erich.realtimerendering.com/minecraft/public/mineways/MinewaysMac.zip">Download the ancient version V5.10 for the Mac</a>. Ported to the Mac OS X platform by using <a href="http://www.davidbaumgold.com/tutorials/wine-mac/">WINE</a>. See <a href="downloads.html#mac">the Mac guide</a>.
<LI><b><a href="https://github.com/erich666/Mineways">Download the source code (C/C++)</a></b> - on github, free for just about any use; code contributions welcome!
<LI><a href="https://www.minecraftforum.net/forums/minecraft-java-edition/discussion/326119-mineways-3d-prints-of-minecraft-objects?page=100">Minecraft forum thread</a>
<LI><b><a title="Subreddit" href="http://www.reddit.com/r/mineways/">Subreddit for Mineways</a></b> - a place to show off your work and tutorials.
<LI><a href="https://minecraft.wiki/w/Programs_and_editors/3D_exporters">Related tools</a> on the Minecraft Wiki.
<LI><b><a href="http://www.youtube.com/playlist?list=PL3AE7AB94E9114715&feature=mh_lolz">Video Playlist</a></b> - where in <a href="http://www.youtube.com/watch?v=MTAztZjP3ak&list=PL3AE7AB94E9114715&index=1&feature=plpp_video">the first two minutes</a> I install Mineways, export a model from <a href="http://vokselia.com">our Minecraft world</a>, preview the result, and then upload it to Shapeways. Tutorials:
<UL>
<LI><b><a href="http://www.youtube.com/watch?v=8I5K-nB86z4">Mineways tutorial: The Basics</a></b>
<LI><b><a href="http://youtu.be/NSK3_7yzUbo">Mineways tutorial: How to use the Mac version</a></b>
<LI><a href="http://www.youtube.com/watch?v=9ZJZMZEfEC0">Mineways tutorial: 3D print cleanup</a>
<LI><a href="http://www.youtube.com/watch?v=K3Un7uCm3Jg&t=0m44s">Mineways with a RepRap home printer</a> - the tutorial itself is <a href="http://repraprip.blogspot.com/2012/01/tutorial-printing-from-minecraft-with.html">here</a>.
<LI><a href="http://www.youtube.com/watch?v=xx4WNvV6k4E">How to make a Minecraft scene in Cinema 4D</a> - also see the step-by-step tutorial <a href="#c4d">here</a>.
<LI><a href="http://www.youtube.com/results?search_type=videos&search_query=mineways&search_sort=video_date_uploaded">Search YouTube</a> for newer Mineways videos.
</UL>
<LI><b><a href="http://www.flickr.com/groups/mineways/pool/">Mineways Flickr group</a></b>. Best photo so far: <a href="http://www.flickr.com/photos/postapocalyptic/6606221371/in/pool-1862849@N21/">this one</a> (not made in Mineways, but it could have been). Note: logging into Flickr appears to <a href="http://www.flickr.com/help/forum/82334/?search=group+visible">allow you to see more images</a> in this group, due to their account review policy. If you submit images, I recommend submitting 5 or more (do some close ups) to avoid their limitations - less than 5 and your photos can only be seen by people signed into Flickr (goofy, I know).
<LI>Search Shapeways for models tagged with <a href="http://www.shapeways.com/search?q=minecraft">"Minecraft"</a> or <a href="http://www.shapeways.com/search?q=mineways">"Mineways"</a>. You can also <a href="https://www.google.com/search?hl=en&rlz=1C1ARAB_enUS470US470&q=site:shapeways.com+minecraft&ix=sea&bav=on.2,or.r_gc.r_pw.r_cp.r_qf.,cf.osb&biw=1920&bih=1032&um=1&ie=UTF-8&tbm=isch&source=og&sa=N&tab=wi&ei=VHqDT4yKE4ig9QTn_KX2Bw">search via Google Images</a>.
<LI><a href="http://www.shapeways.com/shops/mineways">My modest (non-profit) Shapeways shop</a> shows some buildings I've exported and purchased, mostly for friends. You can look at photos, check prices, and download the models themselves.
<LI>You can upload and host models on <a href="https://sketchfab.com">Sketchfab</a>. Here's <a href="https://sketchfab.com/erich">my area</a>, and here's <a href="https://sketchfab.com/search?q=mineways&type=models">all models tagged with "Mineways"</a>.
<LI>If you're using 3D printing and Minecraft in the classroom, one place to look for support is the <a href="https://groups.google.com/forum/#!forum/minecraft-teachers">Minecraft teachers Google Group</a>.
<LI>You can download <a href="https://erich.realtimerendering.com/minecraft/public/mineways/presentations">some slidesets</a> I've used in talks and workshops on 3D printing and Minecraft. Feel free to reuse them in reasonable, Fair Use ways.
<LI>Things made at the Cambridge Science Festival and by <a href="http://partsandcrafts.org/">Parts &amp; Crafts</a> workshop participants are <a href="http://www.shapeways.com/shops/csf">here</a> on the Shapeways site.
<LI><a href="http://vokselia.com">Our world's homepage</a>
</UL>

<H1>
<a id="credits">Credits</a>
</H1>
The Mineways program is <a href="https://github.com/erich666/Mineways">open source</a> and is based on the (late, great) mapping program <a href="http://seancode.com/minutor/">minutor</a> written by Sean Kasun - his work gave me a huge head start. Mineways is a superset of his mapper, with a model exporter and other features added, though with slower map loading than his much-evolved version. I wrote this program just for fun, I'm not associated with Shapeways or Mojang; more about me <a href="http://erichaines.com">here</a>. There are other print services besides <a href="http://shapeways.com">Shapeways</a> that work with Mineways, such as <a href="http://sculpteo.com/">Sculpteo</a>, <a href="http://i.materialise.com/">i.materialise</a> and <a href="http://ponoko.com">Ponoko</a>, as well as <a href="http://bit.ly/info3dp">home 3D printers</a>.

<HR>

<div id="teapotImgs">
<a href="http://vokselia.com"><img src="images/teapot.gif"></a>
<img src="images/teapot_real.jpg">
<a href="http://www.shapeways.com/shops/mineways"><img src="images/teapot_shop.jpg"></a>
</div>

	</div> <!-- /content -->
	<div id="footer">
		<hr>
		<p>Webmaster: <a href="mailto:erich@acm.org">Eric Haines</a>, erich@acm.org - visit the <a href="contact.html">support page</a>
		<br id="lastUpdate">Last updated 1/4/2024</p>
	</div>
</div>

</body>
</html>


